@sixb/client 0.2.1 → 0.2.3

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 (84) hide show
  1. package/dist/artifact-live.d.ts +31 -0
  2. package/dist/artifact-live.d.ts.map +1 -0
  3. package/dist/artifact-live.js +67 -0
  4. package/dist/artifact-live.js.map +10 -0
  5. package/dist/browser.d.ts +5 -0
  6. package/dist/browser.d.ts.map +1 -1
  7. package/dist/browser.js +38 -17
  8. package/dist/browser.js.map +3 -3
  9. package/dist/{chunk-j9t5h44d.js → chunk-15ynvne0.js} +40 -28
  10. package/dist/{chunk-j9t5h44d.js.map → chunk-15ynvne0.js.map} +4 -4
  11. package/dist/{chunk-0p42gyb5.js → chunk-90q7wa43.js} +30 -21
  12. package/dist/chunk-90q7wa43.js.map +17 -0
  13. package/dist/{chunk-rrexv1gk.js → chunk-bgpzb1fn.js} +6 -6
  14. package/dist/{chunk-rrexv1gk.js.map → chunk-bgpzb1fn.js.map} +1 -1
  15. package/dist/{chunk-hkn0keqj.js → chunk-br10prhs.js} +4 -4
  16. package/dist/{chunk-hkn0keqj.js.map → chunk-br10prhs.js.map} +1 -1
  17. package/dist/chunk-hj4h6hw6.js +827 -0
  18. package/dist/chunk-hj4h6hw6.js.map +18 -0
  19. package/dist/{chunk-3kfn00we.js → chunk-ktqfenfd.js} +43 -11
  20. package/dist/chunk-ktqfenfd.js.map +10 -0
  21. package/dist/{chunk-r50kxqa5.js → chunk-seeyb9k9.js} +8 -6
  22. package/dist/{chunk-r50kxqa5.js.map → chunk-seeyb9k9.js.map} +2 -2
  23. package/dist/{chunk-m2rmbshc.js → chunk-y9mhb8x4.js} +3 -1
  24. package/dist/chunk-y9mhb8x4.js.map +10 -0
  25. package/dist/{chunk-k2na62sa.js → chunk-zerhr00d.js} +155 -832
  26. package/dist/chunk-zerhr00d.js.map +10 -0
  27. package/dist/client-authority.d.ts +11 -0
  28. package/dist/client-authority.d.ts.map +1 -1
  29. package/dist/connectors/connection.d.ts +8 -3
  30. package/dist/connectors/connection.d.ts.map +1 -1
  31. package/dist/connectors/mutations.d.ts +4 -0
  32. package/dist/connectors/mutations.d.ts.map +1 -1
  33. package/dist/connectors/queries.d.ts +98 -0
  34. package/dist/connectors/queries.d.ts.map +1 -1
  35. package/dist/events-builder.d.ts +2 -0
  36. package/dist/events-builder.d.ts.map +1 -1
  37. package/dist/events-provider.d.ts.map +1 -1
  38. package/dist/events-transport.d.ts.map +1 -1
  39. package/dist/file.d.ts +8 -0
  40. package/dist/file.d.ts.map +1 -1
  41. package/dist/generated/@tanstack/react-query.gen.d.ts +1439 -234
  42. package/dist/generated/@tanstack/react-query.gen.d.ts.map +1 -1
  43. package/dist/generated/index.d.ts +2 -2
  44. package/dist/generated/index.d.ts.map +1 -1
  45. package/dist/generated/sdk.gen.d.ts +85 -5
  46. package/dist/generated/sdk.gen.d.ts.map +1 -1
  47. package/dist/generated/types.gen.d.ts +2717 -128
  48. package/dist/generated/types.gen.d.ts.map +1 -1
  49. package/dist/hooks.js +306 -57
  50. package/dist/hooks.js.map +7 -7
  51. package/dist/index.js +88 -56
  52. package/dist/index.js.map +1 -1
  53. package/dist/logs.js +6 -5
  54. package/dist/logs.js.map +1 -1
  55. package/dist/models.d.ts +5 -2
  56. package/dist/models.d.ts.map +1 -1
  57. package/dist/models.js +36 -6
  58. package/dist/models.js.map +1 -1
  59. package/dist/query.js +6 -5
  60. package/dist/query.js.map +1 -1
  61. package/dist/users-hooks.d.ts.map +1 -1
  62. package/dist/ws-socket.d.ts +17 -2
  63. package/dist/ws-socket.d.ts.map +1 -1
  64. package/package.json +8 -2
  65. package/src/artifact-live.ts +97 -0
  66. package/src/browser.ts +43 -5
  67. package/src/client-authority.ts +21 -0
  68. package/src/connectors/connection.ts +34 -12
  69. package/src/connectors/mutations.ts +8 -2
  70. package/src/connectors/queries.ts +6 -2
  71. package/src/events-builder.ts +9 -8
  72. package/src/events-provider.ts +13 -0
  73. package/src/events-transport.ts +3 -0
  74. package/src/file.ts +17 -0
  75. package/src/generated/@tanstack/react-query.gen.ts +458 -16
  76. package/src/generated/index.ts +90 -6
  77. package/src/generated/sdk.gen.ts +360 -11
  78. package/src/generated/types.gen.ts +3009 -227
  79. package/src/models.ts +6 -2
  80. package/src/ws-socket.ts +64 -10
  81. package/dist/chunk-0p42gyb5.js.map +0 -17
  82. package/dist/chunk-3kfn00we.js.map +0 -10
  83. package/dist/chunk-k2na62sa.js.map +0 -19
  84. package/dist/chunk-m2rmbshc.js.map +0 -10
@@ -105,18 +105,23 @@ export type ObjectQueryFacetsResponse = {
105
105
  export type ArtifactErrorResponse = {
106
106
  error: string
107
107
  /**
108
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
108
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
109
109
  */
110
110
  code?: string
111
111
  /**
112
- * With artifact_moved: the latest version and who published it
112
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
113
113
  */
114
114
  latest?: {
115
115
  version: number
116
+ revision: number
116
117
  author: {
117
118
  type: "user" | "serviceAccount" | "system"
118
119
  id: string
119
120
  }
121
+ frozenBy?: {
122
+ type: "user" | "serviceAccount" | "system"
123
+ id: string
124
+ }
120
125
  }
121
126
  }
122
127
 
@@ -200,6 +205,7 @@ export type ArtifactQueryProperty = {
200
205
  | "uuid"
201
206
  | "fileRef"
202
207
  | "userRef"
208
+ | "artifactRef"
203
209
  | "enum"
204
210
  | "array"
205
211
  | "object"
@@ -4811,27 +4817,23 @@ export type GetStatusResponses = {
4811
4817
  * Response for status 200
4812
4818
  */
4813
4819
  200: {
4814
- status: "ok" | "degraded"
4820
+ status: "ok" | "degraded" | "unknown"
4815
4821
  objectTypes: number
4816
4822
  maintenance: {
4817
- running: boolean
4818
- intervalMs: number
4819
- lastStartedAt: string | null
4820
- lastCompletedAt: string | null
4821
- lastDurationMs: number | null
4822
- consecutiveFailures: number
4823
- lastError: string | null
4823
+ owner: "orchestrator" | "embedded"
4824
+ beatAt: string | null
4825
+ stale: boolean
4826
+ passes: Array<{
4827
+ id: string
4828
+ lastSucceededAt: string | null
4829
+ consecutiveFailures: number
4830
+ }>
4824
4831
  outbox: {
4825
4832
  pendingCount: number
4826
4833
  oldestPendingAt: string | null
4827
4834
  retryingCount: number
4828
4835
  maxAttempts: number
4829
- } | null
4830
- cleanup: {
4831
- publishedOutboxRowsDeleted: number
4832
- terminalSourceRowsDeleted: number
4833
- terminalSourceMaterializationsDeleted: number
4834
- } | null
4836
+ }
4835
4837
  }
4836
4838
  }
4837
4839
  }
@@ -4918,7 +4920,9 @@ export type ListConnectorConnectionsData = {
4918
4920
  path: {
4919
4921
  connectorId: string
4920
4922
  }
4921
- query?: never
4923
+ query?: {
4924
+ owner?: "project" | "me"
4925
+ }
4922
4926
  url: "/api/connectors/{connectorId}/connections"
4923
4927
  }
4924
4928
 
@@ -4971,9 +4975,14 @@ export type ListConnectorConnectionsResponses = {
4971
4975
  200: Array<{
4972
4976
  id: string
4973
4977
  connectorId: string
4974
- owner: {
4975
- type: "project"
4976
- }
4978
+ owner:
4979
+ | {
4980
+ type: "project"
4981
+ }
4982
+ | {
4983
+ type: "user"
4984
+ id: string
4985
+ }
4977
4986
  slot: string
4978
4987
  account: {
4979
4988
  id: string
@@ -5162,9 +5171,14 @@ export type RevokeConnectorConnectionResponses = {
5162
5171
  affectedConnections: Array<{
5163
5172
  id: string
5164
5173
  connectorId: string
5165
- owner: {
5166
- type: "project"
5167
- }
5174
+ owner:
5175
+ | {
5176
+ type: "project"
5177
+ }
5178
+ | {
5179
+ type: "user"
5180
+ id: string
5181
+ }
5168
5182
  slot: string
5169
5183
  account: {
5170
5184
  id: string
@@ -5240,9 +5254,14 @@ export type ListPendingConnectorConnectionRunsResponses = {
5240
5254
  id: string
5241
5255
  connectorId: string
5242
5256
  kind: "connect" | "reauthorize"
5243
- owner: {
5244
- type: "project"
5245
- }
5257
+ owner:
5258
+ | {
5259
+ type: "project"
5260
+ }
5261
+ | {
5262
+ type: "user"
5263
+ id: string
5264
+ }
5246
5265
  slot: string
5247
5266
  createdAt: string
5248
5267
  updatedAt: string
@@ -5254,9 +5273,14 @@ export type ListPendingConnectorConnectionRunsResponses = {
5254
5273
  id: string
5255
5274
  connectorId: string
5256
5275
  kind: "connect" | "reauthorize"
5257
- owner: {
5258
- type: "project"
5259
- }
5276
+ owner:
5277
+ | {
5278
+ type: "project"
5279
+ }
5280
+ | {
5281
+ type: "user"
5282
+ id: string
5283
+ }
5260
5284
  slot: string
5261
5285
  createdAt: string
5262
5286
  updatedAt: string
@@ -5266,9 +5290,14 @@ export type ListPendingConnectorConnectionRunsResponses = {
5266
5290
  id: string
5267
5291
  connectorId: string
5268
5292
  kind: "connect" | "reauthorize"
5269
- owner: {
5270
- type: "project"
5271
- }
5293
+ owner:
5294
+ | {
5295
+ type: "project"
5296
+ }
5297
+ | {
5298
+ type: "user"
5299
+ id: string
5300
+ }
5272
5301
  slot: string
5273
5302
  createdAt: string
5274
5303
  updatedAt: string
@@ -5285,9 +5314,14 @@ export type ListPendingConnectorConnectionRunsResponses = {
5285
5314
  id: string
5286
5315
  connectorId: string
5287
5316
  kind: "connect" | "reauthorize"
5288
- owner: {
5289
- type: "project"
5290
- }
5317
+ owner:
5318
+ | {
5319
+ type: "project"
5320
+ }
5321
+ | {
5322
+ type: "user"
5323
+ id: string
5324
+ }
5291
5325
  slot: string
5292
5326
  createdAt: string
5293
5327
  updatedAt: string
@@ -5295,9 +5329,14 @@ export type ListPendingConnectorConnectionRunsResponses = {
5295
5329
  connections: Array<{
5296
5330
  id: string
5297
5331
  connectorId: string
5298
- owner: {
5299
- type: "project"
5300
- }
5332
+ owner:
5333
+ | {
5334
+ type: "project"
5335
+ }
5336
+ | {
5337
+ type: "user"
5338
+ id: string
5339
+ }
5301
5340
  slot: string
5302
5341
  account: {
5303
5342
  id: string
@@ -5313,9 +5352,14 @@ export type ListPendingConnectorConnectionRunsResponses = {
5313
5352
  id: string
5314
5353
  connectorId: string
5315
5354
  kind: "connect" | "reauthorize"
5316
- owner: {
5317
- type: "project"
5318
- }
5355
+ owner:
5356
+ | {
5357
+ type: "project"
5358
+ }
5359
+ | {
5360
+ type: "user"
5361
+ id: string
5362
+ }
5319
5363
  slot: string
5320
5364
  createdAt: string
5321
5365
  updatedAt: string
@@ -5357,9 +5401,14 @@ export type ListPendingConnectorConnectionRunsResponses = {
5357
5401
  id: string
5358
5402
  connectorId: string
5359
5403
  kind: "connect" | "reauthorize"
5360
- owner: {
5361
- type: "project"
5362
- }
5404
+ owner:
5405
+ | {
5406
+ type: "project"
5407
+ }
5408
+ | {
5409
+ type: "user"
5410
+ id: string
5411
+ }
5363
5412
  slot: string
5364
5413
  createdAt: string
5365
5414
  updatedAt: string
@@ -5374,6 +5423,7 @@ export type ListPendingConnectorConnectionRunsResponse =
5374
5423
 
5375
5424
  export type StartConnectorConnectionRunData = {
5376
5425
  body: {
5426
+ owner?: "project" | "me"
5377
5427
  slot: string
5378
5428
  returnTo: string
5379
5429
  }
@@ -5471,9 +5521,14 @@ export type StartConnectorConnectionRunResponses = {
5471
5521
  affectedConnections: Array<{
5472
5522
  id: string
5473
5523
  connectorId: string
5474
- owner: {
5475
- type: "project"
5476
- }
5524
+ owner:
5525
+ | {
5526
+ type: "project"
5527
+ }
5528
+ | {
5529
+ type: "user"
5530
+ id: string
5531
+ }
5477
5532
  slot: string
5478
5533
  account: {
5479
5534
  id: string
@@ -5550,9 +5605,14 @@ export type GetConnectorConnectionRunResponses = {
5550
5605
  id: string
5551
5606
  connectorId: string
5552
5607
  kind: "connect" | "reauthorize"
5553
- owner: {
5554
- type: "project"
5555
- }
5608
+ owner:
5609
+ | {
5610
+ type: "project"
5611
+ }
5612
+ | {
5613
+ type: "user"
5614
+ id: string
5615
+ }
5556
5616
  slot: string
5557
5617
  createdAt: string
5558
5618
  updatedAt: string
@@ -5564,9 +5624,14 @@ export type GetConnectorConnectionRunResponses = {
5564
5624
  id: string
5565
5625
  connectorId: string
5566
5626
  kind: "connect" | "reauthorize"
5567
- owner: {
5568
- type: "project"
5569
- }
5627
+ owner:
5628
+ | {
5629
+ type: "project"
5630
+ }
5631
+ | {
5632
+ type: "user"
5633
+ id: string
5634
+ }
5570
5635
  slot: string
5571
5636
  createdAt: string
5572
5637
  updatedAt: string
@@ -5576,9 +5641,14 @@ export type GetConnectorConnectionRunResponses = {
5576
5641
  id: string
5577
5642
  connectorId: string
5578
5643
  kind: "connect" | "reauthorize"
5579
- owner: {
5580
- type: "project"
5581
- }
5644
+ owner:
5645
+ | {
5646
+ type: "project"
5647
+ }
5648
+ | {
5649
+ type: "user"
5650
+ id: string
5651
+ }
5582
5652
  slot: string
5583
5653
  createdAt: string
5584
5654
  updatedAt: string
@@ -5595,9 +5665,14 @@ export type GetConnectorConnectionRunResponses = {
5595
5665
  id: string
5596
5666
  connectorId: string
5597
5667
  kind: "connect" | "reauthorize"
5598
- owner: {
5599
- type: "project"
5600
- }
5668
+ owner:
5669
+ | {
5670
+ type: "project"
5671
+ }
5672
+ | {
5673
+ type: "user"
5674
+ id: string
5675
+ }
5601
5676
  slot: string
5602
5677
  createdAt: string
5603
5678
  updatedAt: string
@@ -5605,9 +5680,14 @@ export type GetConnectorConnectionRunResponses = {
5605
5680
  connections: Array<{
5606
5681
  id: string
5607
5682
  connectorId: string
5608
- owner: {
5609
- type: "project"
5610
- }
5683
+ owner:
5684
+ | {
5685
+ type: "project"
5686
+ }
5687
+ | {
5688
+ type: "user"
5689
+ id: string
5690
+ }
5611
5691
  slot: string
5612
5692
  account: {
5613
5693
  id: string
@@ -5623,9 +5703,14 @@ export type GetConnectorConnectionRunResponses = {
5623
5703
  id: string
5624
5704
  connectorId: string
5625
5705
  kind: "connect" | "reauthorize"
5626
- owner: {
5627
- type: "project"
5628
- }
5706
+ owner:
5707
+ | {
5708
+ type: "project"
5709
+ }
5710
+ | {
5711
+ type: "user"
5712
+ id: string
5713
+ }
5629
5714
  slot: string
5630
5715
  createdAt: string
5631
5716
  updatedAt: string
@@ -5667,9 +5752,14 @@ export type GetConnectorConnectionRunResponses = {
5667
5752
  id: string
5668
5753
  connectorId: string
5669
5754
  kind: "connect" | "reauthorize"
5670
- owner: {
5671
- type: "project"
5672
- }
5755
+ owner:
5756
+ | {
5757
+ type: "project"
5758
+ }
5759
+ | {
5760
+ type: "user"
5761
+ id: string
5762
+ }
5673
5763
  slot: string
5674
5764
  createdAt: string
5675
5765
  updatedAt: string
@@ -5683,6 +5773,7 @@ export type GetConnectorConnectionRunResponse =
5683
5773
 
5684
5774
  export type AddConnectorConnectionData = {
5685
5775
  body: {
5776
+ owner?: "project" | "me"
5686
5777
  slot: string
5687
5778
  }
5688
5779
  path: {
@@ -5759,9 +5850,14 @@ export type AddConnectorConnectionResponses = {
5759
5850
  id: string
5760
5851
  connectorId: string
5761
5852
  kind: "connect" | "reauthorize"
5762
- owner: {
5763
- type: "project"
5764
- }
5853
+ owner:
5854
+ | {
5855
+ type: "project"
5856
+ }
5857
+ | {
5858
+ type: "user"
5859
+ id: string
5860
+ }
5765
5861
  slot: string
5766
5862
  createdAt: string
5767
5863
  updatedAt: string
@@ -5773,9 +5869,14 @@ export type AddConnectorConnectionResponses = {
5773
5869
  id: string
5774
5870
  connectorId: string
5775
5871
  kind: "connect" | "reauthorize"
5776
- owner: {
5777
- type: "project"
5778
- }
5872
+ owner:
5873
+ | {
5874
+ type: "project"
5875
+ }
5876
+ | {
5877
+ type: "user"
5878
+ id: string
5879
+ }
5779
5880
  slot: string
5780
5881
  createdAt: string
5781
5882
  updatedAt: string
@@ -5785,9 +5886,14 @@ export type AddConnectorConnectionResponses = {
5785
5886
  id: string
5786
5887
  connectorId: string
5787
5888
  kind: "connect" | "reauthorize"
5788
- owner: {
5789
- type: "project"
5790
- }
5889
+ owner:
5890
+ | {
5891
+ type: "project"
5892
+ }
5893
+ | {
5894
+ type: "user"
5895
+ id: string
5896
+ }
5791
5897
  slot: string
5792
5898
  createdAt: string
5793
5899
  updatedAt: string
@@ -5804,9 +5910,14 @@ export type AddConnectorConnectionResponses = {
5804
5910
  id: string
5805
5911
  connectorId: string
5806
5912
  kind: "connect" | "reauthorize"
5807
- owner: {
5808
- type: "project"
5809
- }
5913
+ owner:
5914
+ | {
5915
+ type: "project"
5916
+ }
5917
+ | {
5918
+ type: "user"
5919
+ id: string
5920
+ }
5810
5921
  slot: string
5811
5922
  createdAt: string
5812
5923
  updatedAt: string
@@ -5814,9 +5925,14 @@ export type AddConnectorConnectionResponses = {
5814
5925
  connections: Array<{
5815
5926
  id: string
5816
5927
  connectorId: string
5817
- owner: {
5818
- type: "project"
5819
- }
5928
+ owner:
5929
+ | {
5930
+ type: "project"
5931
+ }
5932
+ | {
5933
+ type: "user"
5934
+ id: string
5935
+ }
5820
5936
  slot: string
5821
5937
  account: {
5822
5938
  id: string
@@ -5832,9 +5948,14 @@ export type AddConnectorConnectionResponses = {
5832
5948
  id: string
5833
5949
  connectorId: string
5834
5950
  kind: "connect" | "reauthorize"
5835
- owner: {
5836
- type: "project"
5837
- }
5951
+ owner:
5952
+ | {
5953
+ type: "project"
5954
+ }
5955
+ | {
5956
+ type: "user"
5957
+ id: string
5958
+ }
5838
5959
  slot: string
5839
5960
  createdAt: string
5840
5961
  updatedAt: string
@@ -5876,9 +5997,14 @@ export type AddConnectorConnectionResponses = {
5876
5997
  id: string
5877
5998
  connectorId: string
5878
5999
  kind: "connect" | "reauthorize"
5879
- owner: {
5880
- type: "project"
5881
- }
6000
+ owner:
6001
+ | {
6002
+ type: "project"
6003
+ }
6004
+ | {
6005
+ type: "user"
6006
+ id: string
6007
+ }
5882
6008
  slot: string
5883
6009
  createdAt: string
5884
6010
  updatedAt: string
@@ -5969,9 +6095,14 @@ export type SelectConnectorConnectionRunAccountResponses = {
5969
6095
  id: string
5970
6096
  connectorId: string
5971
6097
  kind: "connect" | "reauthorize"
5972
- owner: {
5973
- type: "project"
5974
- }
6098
+ owner:
6099
+ | {
6100
+ type: "project"
6101
+ }
6102
+ | {
6103
+ type: "user"
6104
+ id: string
6105
+ }
5975
6106
  slot: string
5976
6107
  createdAt: string
5977
6108
  updatedAt: string
@@ -5983,9 +6114,14 @@ export type SelectConnectorConnectionRunAccountResponses = {
5983
6114
  id: string
5984
6115
  connectorId: string
5985
6116
  kind: "connect" | "reauthorize"
5986
- owner: {
5987
- type: "project"
5988
- }
6117
+ owner:
6118
+ | {
6119
+ type: "project"
6120
+ }
6121
+ | {
6122
+ type: "user"
6123
+ id: string
6124
+ }
5989
6125
  slot: string
5990
6126
  createdAt: string
5991
6127
  updatedAt: string
@@ -5995,9 +6131,14 @@ export type SelectConnectorConnectionRunAccountResponses = {
5995
6131
  id: string
5996
6132
  connectorId: string
5997
6133
  kind: "connect" | "reauthorize"
5998
- owner: {
5999
- type: "project"
6000
- }
6134
+ owner:
6135
+ | {
6136
+ type: "project"
6137
+ }
6138
+ | {
6139
+ type: "user"
6140
+ id: string
6141
+ }
6001
6142
  slot: string
6002
6143
  createdAt: string
6003
6144
  updatedAt: string
@@ -6014,19 +6155,29 @@ export type SelectConnectorConnectionRunAccountResponses = {
6014
6155
  id: string
6015
6156
  connectorId: string
6016
6157
  kind: "connect" | "reauthorize"
6017
- owner: {
6018
- type: "project"
6019
- }
6020
- slot: string
6021
- createdAt: string
6022
- updatedAt: string
6023
- status: "succeeded"
6024
- connections: Array<{
6158
+ owner:
6159
+ | {
6160
+ type: "project"
6161
+ }
6162
+ | {
6163
+ type: "user"
6164
+ id: string
6165
+ }
6166
+ slot: string
6167
+ createdAt: string
6168
+ updatedAt: string
6169
+ status: "succeeded"
6170
+ connections: Array<{
6025
6171
  id: string
6026
6172
  connectorId: string
6027
- owner: {
6028
- type: "project"
6029
- }
6173
+ owner:
6174
+ | {
6175
+ type: "project"
6176
+ }
6177
+ | {
6178
+ type: "user"
6179
+ id: string
6180
+ }
6030
6181
  slot: string
6031
6182
  account: {
6032
6183
  id: string
@@ -6042,9 +6193,14 @@ export type SelectConnectorConnectionRunAccountResponses = {
6042
6193
  id: string
6043
6194
  connectorId: string
6044
6195
  kind: "connect" | "reauthorize"
6045
- owner: {
6046
- type: "project"
6047
- }
6196
+ owner:
6197
+ | {
6198
+ type: "project"
6199
+ }
6200
+ | {
6201
+ type: "user"
6202
+ id: string
6203
+ }
6048
6204
  slot: string
6049
6205
  createdAt: string
6050
6206
  updatedAt: string
@@ -6086,9 +6242,14 @@ export type SelectConnectorConnectionRunAccountResponses = {
6086
6242
  id: string
6087
6243
  connectorId: string
6088
6244
  kind: "connect" | "reauthorize"
6089
- owner: {
6090
- type: "project"
6091
- }
6245
+ owner:
6246
+ | {
6247
+ type: "project"
6248
+ }
6249
+ | {
6250
+ type: "user"
6251
+ id: string
6252
+ }
6092
6253
  slot: string
6093
6254
  createdAt: string
6094
6255
  updatedAt: string
@@ -6199,9 +6360,14 @@ export type ReauthorizeConnectorConnectionResponses = {
6199
6360
  affectedConnections: Array<{
6200
6361
  id: string
6201
6362
  connectorId: string
6202
- owner: {
6203
- type: "project"
6204
- }
6363
+ owner:
6364
+ | {
6365
+ type: "project"
6366
+ }
6367
+ | {
6368
+ type: "user"
6369
+ id: string
6370
+ }
6205
6371
  slot: string
6206
6372
  account: {
6207
6373
  id: string
@@ -6685,6 +6851,104 @@ export type ListDatasetRowsResponses = {
6685
6851
 
6686
6852
  export type ListDatasetRowsResponse = ListDatasetRowsResponses[keyof ListDatasetRowsResponses]
6687
6853
 
6854
+ export type GetLakeHealthData = {
6855
+ body?: never
6856
+ path?: never
6857
+ query?: never
6858
+ url: "/api/lake/health"
6859
+ }
6860
+
6861
+ export type GetLakeHealthErrors = {
6862
+ /**
6863
+ * Response for status 400
6864
+ */
6865
+ 400: {
6866
+ error: string
6867
+ }
6868
+ }
6869
+
6870
+ export type GetLakeHealthError = GetLakeHealthErrors[keyof GetLakeHealthErrors]
6871
+
6872
+ export type GetLakeHealthResponses = {
6873
+ /**
6874
+ * Response for status 200
6875
+ */
6876
+ 200: {
6877
+ /**
6878
+ * Whether the lake storage provider supports maintenance
6879
+ */
6880
+ available: boolean
6881
+ cleanup: {
6882
+ /**
6883
+ * What actually happens: `not-requested` when no orchestrator asks, `no-worker` when no lake worker runs what it asks
6884
+ */
6885
+ state: "off" | "idle" | "not-requested" | "no-worker" | "failing" | "cleaning" | "ok"
6886
+ /**
6887
+ * When the orchestrator last asked for cleanup
6888
+ */
6889
+ lastRequestedAt: string | null
6890
+ /**
6891
+ * When a lake worker last started a cleanup
6892
+ */
6893
+ lastRunAt: string | null
6894
+ keepVersionsFor: string
6895
+ deleteFilesAfter: string
6896
+ cleanupEvery: string
6897
+ }
6898
+ datasets: Array<{
6899
+ datasetId: string
6900
+ /**
6901
+ * Whether the dataset has a table in the lake
6902
+ */
6903
+ materialized: boolean
6904
+ rowCount: number
6905
+ /**
6906
+ * Data files its current rows are read from
6907
+ */
6908
+ dataFiles: number
6909
+ /**
6910
+ * Data files small enough that compaction merges them
6911
+ */
6912
+ smallDataFiles: number
6913
+ dataBytes: number
6914
+ /**
6915
+ * Files listing deleted rows, until compaction
6916
+ */
6917
+ deleteFiles: number
6918
+ /**
6919
+ * Rows kept in the catalog rather than in files
6920
+ */
6921
+ inlinedRows: number
6922
+ /**
6923
+ * Commits still in the dataset's history
6924
+ */
6925
+ retainedSnapshots: number
6926
+ partitionBy: Array<string>
6927
+ warnings: Array<{
6928
+ code: "partitioned-small-dataset"
6929
+ message: string
6930
+ }>
6931
+ /**
6932
+ * Ingested changes waiting or refused; null when there are none
6933
+ */
6934
+ ingest: {
6935
+ pendingDeliveries: number
6936
+ pendingChanges: number
6937
+ /**
6938
+ * When the oldest waiting delivery arrived
6939
+ */
6940
+ oldestReceivedAt: string | null
6941
+ /**
6942
+ * Deliveries refused when written, kept for a week to read and send again
6943
+ */
6944
+ rejectedDeliveries: number
6945
+ } | null
6946
+ }>
6947
+ }
6948
+ }
6949
+
6950
+ export type GetLakeHealthResponse = GetLakeHealthResponses[keyof GetLakeHealthResponses]
6951
+
6688
6952
  export type ListSyncsData = {
6689
6953
  body?: never
6690
6954
  path?: never
@@ -6740,6 +7004,7 @@ export type ListSyncsResponses = {
6740
7004
  datasetId: string
6741
7005
  mode: "snapshot" | "append" | "merge"
6742
7006
  status: "queued" | "running" | "succeeded" | "failed" | "cancelled"
7007
+ attempt: number
6743
7008
  queuedAt: string
6744
7009
  startedAt?: string
6745
7010
  finishedAt?: string
@@ -6849,6 +7114,7 @@ export type GetSyncResponses = {
6849
7114
  datasetId: string
6850
7115
  mode: "snapshot" | "append" | "merge"
6851
7116
  status: "queued" | "running" | "succeeded" | "failed" | "cancelled"
7117
+ attempt: number
6852
7118
  queuedAt: string
6853
7119
  startedAt?: string
6854
7120
  finishedAt?: string
@@ -6935,6 +7201,7 @@ export type ListSyncRunsResponses = {
6935
7201
  datasetId: string
6936
7202
  mode: "snapshot" | "append" | "merge"
6937
7203
  status: "queued" | "running" | "succeeded" | "failed" | "cancelled"
7204
+ attempt: number
6938
7205
  queuedAt: string
6939
7206
  startedAt?: string
6940
7207
  finishedAt?: string
@@ -7116,6 +7383,7 @@ export type ListPipelinesResponses = {
7116
7383
  projectId: string
7117
7384
  pipelineId: string
7118
7385
  status: "queued" | "running" | "succeeded" | "failed" | "cancelled"
7386
+ attempt: number
7119
7387
  queuedAt: string
7120
7388
  startedAt?: string
7121
7389
  finishedAt?: string
@@ -7256,6 +7524,7 @@ export type GetPipelineResponses = {
7256
7524
  projectId: string
7257
7525
  pipelineId: string
7258
7526
  status: "queued" | "running" | "succeeded" | "failed" | "cancelled"
7527
+ attempt: number
7259
7528
  queuedAt: string
7260
7529
  startedAt?: string
7261
7530
  finishedAt?: string
@@ -7336,6 +7605,7 @@ export type ListPipelineRunsResponses = {
7336
7605
  projectId: string
7337
7606
  pipelineId: string
7338
7607
  status: "queued" | "running" | "succeeded" | "failed" | "cancelled"
7608
+ attempt: number
7339
7609
  queuedAt: string
7340
7610
  startedAt?: string
7341
7611
  finishedAt?: string
@@ -7418,6 +7688,7 @@ export type GetPipelineRunResponses = {
7418
7688
  projectId: string
7419
7689
  pipelineId: string
7420
7690
  status: "queued" | "running" | "succeeded" | "failed" | "cancelled"
7691
+ attempt: number
7421
7692
  queuedAt: string
7422
7693
  startedAt?: string
7423
7694
  finishedAt?: string
@@ -8819,6 +9090,7 @@ export type GetWorkflowAgentNodeExecutionResponses = {
8819
9090
  | "connector.provider_unavailable"
8820
9091
  | "connector.replacement_required"
8821
9092
  | "connector.revocation_pending"
9093
+ | "dataset.change_refused"
8822
9094
  | "dataset.not_found"
8823
9095
  | "dataset.version_incompatible"
8824
9096
  | "dataset.version_not_found"
@@ -10212,6 +10484,14 @@ export type ExchangeSharedAccessResponses = {
10212
10484
  expiresAt: string
10213
10485
  absoluteExpiresAt: string
10214
10486
  csrfToken: string
10487
+ /**
10488
+ * Who the visitor is in this session: the author id of the comments they write as a guest
10489
+ */
10490
+ guestId: string
10491
+ /**
10492
+ * The name the visitor gave, which their comments and live presence carry
10493
+ */
10494
+ guestName?: string
10215
10495
  }
10216
10496
  }
10217
10497
 
@@ -10255,12 +10535,88 @@ export type GetSharedAccessSessionResponses = {
10255
10535
  expiresAt: string
10256
10536
  absoluteExpiresAt: string
10257
10537
  csrfToken: string
10538
+ /**
10539
+ * Who the visitor is in this session: the author id of the comments they write as a guest
10540
+ */
10541
+ guestId: string
10542
+ /**
10543
+ * The name the visitor gave, which their comments and live presence carry
10544
+ */
10545
+ guestName?: string
10258
10546
  }
10259
10547
  }
10260
10548
 
10261
10549
  export type GetSharedAccessSessionResponse =
10262
10550
  GetSharedAccessSessionResponses[keyof GetSharedAccessSessionResponses]
10263
10551
 
10552
+ export type SetSharedAccessGuestNameData = {
10553
+ body: {
10554
+ /**
10555
+ * The visitor's name, on one line: 1 to 60 characters once its spaces are collapsed, without control or direction marks
10556
+ */
10557
+ name: string
10558
+ }
10559
+ path: {
10560
+ grantId: string
10561
+ }
10562
+ query?: never
10563
+ url: "/api/shared-access/{grantId}/name"
10564
+ }
10565
+
10566
+ export type SetSharedAccessGuestNameErrors = {
10567
+ /**
10568
+ * Response for status 400
10569
+ */
10570
+ 400: {
10571
+ error: string
10572
+ }
10573
+ /**
10574
+ * Response for status 401
10575
+ */
10576
+ 401: {
10577
+ error: string
10578
+ }
10579
+ /**
10580
+ * Response for status 403
10581
+ */
10582
+ 403: {
10583
+ error: string
10584
+ }
10585
+ /**
10586
+ * Response for status 503
10587
+ */
10588
+ 503: {
10589
+ error: string
10590
+ }
10591
+ }
10592
+
10593
+ export type SetSharedAccessGuestNameError =
10594
+ SetSharedAccessGuestNameErrors[keyof SetSharedAccessGuestNameErrors]
10595
+
10596
+ export type SetSharedAccessGuestNameResponses = {
10597
+ /**
10598
+ * Response for status 200
10599
+ */
10600
+ 200: {
10601
+ grantId: string
10602
+ destinationPath: string
10603
+ expiresAt: string
10604
+ absoluteExpiresAt: string
10605
+ csrfToken: string
10606
+ /**
10607
+ * Who the visitor is in this session: the author id of the comments they write as a guest
10608
+ */
10609
+ guestId: string
10610
+ /**
10611
+ * The name the visitor gave, which their comments and live presence carry
10612
+ */
10613
+ guestName?: string
10614
+ }
10615
+ }
10616
+
10617
+ export type SetSharedAccessGuestNameResponse =
10618
+ SetSharedAccessGuestNameResponses[keyof SetSharedAccessGuestNameResponses]
10619
+
10264
10620
  export type SignOutSharedAccessData = {
10265
10621
  body?: never
10266
10622
  path: {
@@ -11429,6 +11785,7 @@ export type RequestActionErrors = {
11429
11785
  | "connector.provider_unavailable"
11430
11786
  | "connector.replacement_required"
11431
11787
  | "connector.revocation_pending"
11788
+ | "dataset.change_refused"
11432
11789
  | "dataset.not_found"
11433
11790
  | "dataset.version_incompatible"
11434
11791
  | "dataset.version_not_found"
@@ -13289,6 +13646,7 @@ export type ListAgentThreadMessagesResponses = {
13289
13646
  | "connector.provider_unavailable"
13290
13647
  | "connector.replacement_required"
13291
13648
  | "connector.revocation_pending"
13649
+ | "dataset.change_refused"
13292
13650
  | "dataset.not_found"
13293
13651
  | "dataset.version_incompatible"
13294
13652
  | "dataset.version_not_found"
@@ -15096,6 +15454,40 @@ export type HeadAgentChildFileContentResponses = {
15096
15454
  206: unknown
15097
15455
  }
15098
15456
 
15457
+ export type ListAgentComputersData = {
15458
+ body?: never
15459
+ path?: never
15460
+ query?: never
15461
+ url: "/api/agent-computers"
15462
+ }
15463
+
15464
+ export type ListAgentComputersErrors = {
15465
+ /**
15466
+ * Response for status 501
15467
+ */
15468
+ 501: {
15469
+ error: string
15470
+ }
15471
+ }
15472
+
15473
+ export type ListAgentComputersError = ListAgentComputersErrors[keyof ListAgentComputersErrors]
15474
+
15475
+ export type ListAgentComputersResponses = {
15476
+ /**
15477
+ * Response for status 200
15478
+ */
15479
+ 200: {
15480
+ computers: Array<{
15481
+ id: string
15482
+ name: string
15483
+ folders: Array<string>
15484
+ }>
15485
+ }
15486
+ }
15487
+
15488
+ export type ListAgentComputersResponse =
15489
+ ListAgentComputersResponses[keyof ListAgentComputersResponses]
15490
+
15099
15491
  export type MoveAgentThreadToCloudData = {
15100
15492
  body?: never
15101
15493
  path: {
@@ -15907,6 +16299,7 @@ export type ListAgentThreadApprovalsResponses = {
15907
16299
  | "connector.provider_unavailable"
15908
16300
  | "connector.replacement_required"
15909
16301
  | "connector.revocation_pending"
16302
+ | "dataset.change_refused"
15910
16303
  | "dataset.not_found"
15911
16304
  | "dataset.version_incompatible"
15912
16305
  | "dataset.version_not_found"
@@ -16142,6 +16535,7 @@ export type DecideAgentApprovalResponses = {
16142
16535
  | "connector.provider_unavailable"
16143
16536
  | "connector.replacement_required"
16144
16537
  | "connector.revocation_pending"
16538
+ | "dataset.change_refused"
16145
16539
  | "dataset.not_found"
16146
16540
  | "dataset.version_incompatible"
16147
16541
  | "dataset.version_not_found"
@@ -16482,6 +16876,7 @@ export type ListAgentApprovalsResponses = {
16482
16876
  | "connector.provider_unavailable"
16483
16877
  | "connector.replacement_required"
16484
16878
  | "connector.revocation_pending"
16879
+ | "dataset.change_refused"
16485
16880
  | "dataset.not_found"
16486
16881
  | "dataset.version_incompatible"
16487
16882
  | "dataset.version_not_found"
@@ -16820,6 +17215,7 @@ export type ListObservedAgentThreadMessagesResponses = {
16820
17215
  | "connector.provider_unavailable"
16821
17216
  | "connector.replacement_required"
16822
17217
  | "connector.revocation_pending"
17218
+ | "dataset.change_refused"
16823
17219
  | "dataset.not_found"
16824
17220
  | "dataset.version_incompatible"
16825
17221
  | "dataset.version_not_found"
@@ -17781,7 +18177,7 @@ export type ListArtifactsData = {
17781
18177
  path?: never
17782
18178
  query?: {
17783
18179
  /**
17784
- * Only artifacts with a version the Agent published in this thread
18180
+ * Only artifacts this conversation shares: the Agent wrote them in it
17785
18181
  */
17786
18182
  thread?: string
17787
18183
  /**
@@ -17801,18 +18197,23 @@ export type ListArtifactsErrors = {
17801
18197
  400: {
17802
18198
  error: string
17803
18199
  /**
17804
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18200
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
17805
18201
  */
17806
18202
  code?: string
17807
18203
  /**
17808
- * With artifact_moved: the latest version and who published it
18204
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17809
18205
  */
17810
18206
  latest?: {
17811
18207
  version: number
18208
+ revision: number
17812
18209
  author: {
17813
18210
  type: "user" | "serviceAccount" | "system"
17814
18211
  id: string
17815
18212
  }
18213
+ frozenBy?: {
18214
+ type: "user" | "serviceAccount" | "system"
18215
+ id: string
18216
+ }
17816
18217
  }
17817
18218
  }
17818
18219
  /**
@@ -17821,18 +18222,23 @@ export type ListArtifactsErrors = {
17821
18222
  501: {
17822
18223
  error: string
17823
18224
  /**
17824
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18225
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
17825
18226
  */
17826
18227
  code?: string
17827
18228
  /**
17828
- * With artifact_moved: the latest version and who published it
18229
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17829
18230
  */
17830
18231
  latest?: {
17831
18232
  version: number
18233
+ revision: number
17832
18234
  author: {
17833
18235
  type: "user" | "serviceAccount" | "system"
17834
18236
  id: string
17835
18237
  }
18238
+ frozenBy?: {
18239
+ type: "user" | "serviceAccount" | "system"
18240
+ id: string
18241
+ }
17836
18242
  }
17837
18243
  }
17838
18244
  }
@@ -17854,7 +18260,14 @@ export type ListArtifactsResponses = {
17854
18260
  id: string
17855
18261
  }
17856
18262
  latestVersion: number
18263
+ /**
18264
+ * Counts the artifact's changes: a write, a version created, a restore. It only grows, so content read at one revision is that revision's for good
18265
+ */
18266
+ revision: number
17857
18267
  createdAt: string
18268
+ /**
18269
+ * When the artifact last changed
18270
+ */
17858
18271
  updatedAt: string
17859
18272
  }>
17860
18273
  hasMore: boolean
@@ -17898,18 +18311,23 @@ export type CreateArtifactErrors = {
17898
18311
  400: {
17899
18312
  error: string
17900
18313
  /**
17901
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18314
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
17902
18315
  */
17903
18316
  code?: string
17904
18317
  /**
17905
- * With artifact_moved: the latest version and who published it
18318
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17906
18319
  */
17907
18320
  latest?: {
17908
18321
  version: number
18322
+ revision: number
17909
18323
  author: {
17910
18324
  type: "user" | "serviceAccount" | "system"
17911
18325
  id: string
17912
18326
  }
18327
+ frozenBy?: {
18328
+ type: "user" | "serviceAccount" | "system"
18329
+ id: string
18330
+ }
17913
18331
  }
17914
18332
  }
17915
18333
  /**
@@ -17918,18 +18336,23 @@ export type CreateArtifactErrors = {
17918
18336
  403: {
17919
18337
  error: string
17920
18338
  /**
17921
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18339
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
17922
18340
  */
17923
18341
  code?: string
17924
18342
  /**
17925
- * With artifact_moved: the latest version and who published it
18343
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17926
18344
  */
17927
18345
  latest?: {
17928
18346
  version: number
18347
+ revision: number
17929
18348
  author: {
17930
18349
  type: "user" | "serviceAccount" | "system"
17931
18350
  id: string
17932
18351
  }
18352
+ frozenBy?: {
18353
+ type: "user" | "serviceAccount" | "system"
18354
+ id: string
18355
+ }
17933
18356
  }
17934
18357
  }
17935
18358
  /**
@@ -17938,18 +18361,23 @@ export type CreateArtifactErrors = {
17938
18361
  404: {
17939
18362
  error: string
17940
18363
  /**
17941
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18364
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
17942
18365
  */
17943
18366
  code?: string
17944
18367
  /**
17945
- * With artifact_moved: the latest version and who published it
18368
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17946
18369
  */
17947
18370
  latest?: {
17948
18371
  version: number
18372
+ revision: number
17949
18373
  author: {
17950
18374
  type: "user" | "serviceAccount" | "system"
17951
18375
  id: string
17952
18376
  }
18377
+ frozenBy?: {
18378
+ type: "user" | "serviceAccount" | "system"
18379
+ id: string
18380
+ }
17953
18381
  }
17954
18382
  }
17955
18383
  /**
@@ -17958,18 +18386,23 @@ export type CreateArtifactErrors = {
17958
18386
  409: {
17959
18387
  error: string
17960
18388
  /**
17961
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18389
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
17962
18390
  */
17963
18391
  code?: string
17964
18392
  /**
17965
- * With artifact_moved: the latest version and who published it
18393
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17966
18394
  */
17967
18395
  latest?: {
17968
18396
  version: number
18397
+ revision: number
17969
18398
  author: {
17970
18399
  type: "user" | "serviceAccount" | "system"
17971
18400
  id: string
17972
18401
  }
18402
+ frozenBy?: {
18403
+ type: "user" | "serviceAccount" | "system"
18404
+ id: string
18405
+ }
17973
18406
  }
17974
18407
  }
17975
18408
  /**
@@ -17978,18 +18411,23 @@ export type CreateArtifactErrors = {
17978
18411
  501: {
17979
18412
  error: string
17980
18413
  /**
17981
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18414
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
17982
18415
  */
17983
18416
  code?: string
17984
18417
  /**
17985
- * With artifact_moved: the latest version and who published it
18418
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17986
18419
  */
17987
18420
  latest?: {
17988
18421
  version: number
18422
+ revision: number
17989
18423
  author: {
17990
18424
  type: "user" | "serviceAccount" | "system"
17991
18425
  id: string
17992
18426
  }
18427
+ frozenBy?: {
18428
+ type: "user" | "serviceAccount" | "system"
18429
+ id: string
18430
+ }
17993
18431
  }
17994
18432
  }
17995
18433
  }
@@ -18011,12 +18449,27 @@ export type CreateArtifactResponses = {
18011
18449
  id: string
18012
18450
  }
18013
18451
  latestVersion: number
18452
+ /**
18453
+ * Counts the artifact's changes: a write, a version created, a restore. It only grows, so content read at one revision is that revision's for good
18454
+ */
18455
+ revision: number
18014
18456
  createdAt: string
18457
+ /**
18458
+ * When the artifact last changed
18459
+ */
18015
18460
  updatedAt: string
18016
18461
  }
18017
18462
  version: {
18018
18463
  artifactId: string
18019
18464
  version: number
18465
+ /**
18466
+ * The artifact's revision when this version last changed: the latest version's is the artifact's
18467
+ */
18468
+ revision: number
18469
+ /**
18470
+ * Someone created this version: it never changes again. The latest version is open until then, and each write replaces its content
18471
+ */
18472
+ frozen: boolean
18020
18473
  title: string
18021
18474
  entry: string
18022
18475
  files: Array<{
@@ -18078,6 +18531,10 @@ export type CreateArtifactResponses = {
18078
18531
  file: string
18079
18532
  w: number
18080
18533
  h: number
18534
+ /**
18535
+ * What the board's preview is a picture of: a board kept as it was keeps it
18536
+ */
18537
+ renderKey?: string
18081
18538
  }
18082
18539
  | {
18083
18540
  id: string
@@ -18085,6 +18542,10 @@ export type CreateArtifactResponses = {
18085
18542
  title?: string
18086
18543
  }
18087
18544
  >
18545
+ /**
18546
+ * The modes each board has a preview in: both, or the one its theme.json pins
18547
+ */
18548
+ themes?: Array<"light" | "dark">
18088
18549
  }
18089
18550
  | {
18090
18551
  kind: "file"
@@ -18096,23 +18557,53 @@ export type CreateArtifactResponses = {
18096
18557
  at: string
18097
18558
  resolvedVersion: number
18098
18559
  }>
18560
+ /**
18561
+ * Who last wrote its content
18562
+ */
18099
18563
  author: {
18100
18564
  type: "user" | "serviceAccount" | "system"
18101
18565
  id: string
18102
18566
  }
18567
+ /**
18568
+ * The Agent turn and thread its content was last written from
18569
+ */
18103
18570
  origin?: {
18104
18571
  threadId: string
18105
18572
  runId: string
18106
18573
  }
18574
+ /**
18575
+ * When the version was opened
18576
+ */
18107
18577
  createdAt: string
18108
- }
18109
- warnings: Array<{
18110
- code: string
18111
- message: string
18112
- part?: string
18113
- }>
18114
- }
18115
- }
18578
+ /**
18579
+ * When its content was last written
18580
+ */
18581
+ updatedAt: string
18582
+ /**
18583
+ * When it was created, which froze it
18584
+ */
18585
+ frozenAt?: string
18586
+ /**
18587
+ * Who created it
18588
+ */
18589
+ frozenBy?: {
18590
+ type: "user" | "serviceAccount" | "system"
18591
+ id: string
18592
+ }
18593
+ /**
18594
+ * A canvas's boards by id, as reading or publishing the version returns them: ready when its preview is, pending while it is rendered, none when none will come and the board shows its outline
18595
+ */
18596
+ boardPreviews?: {
18597
+ [key: string]: "ready" | "pending" | "none"
18598
+ }
18599
+ }
18600
+ warnings: Array<{
18601
+ code: string
18602
+ message: string
18603
+ part?: string
18604
+ }>
18605
+ }
18606
+ }
18116
18607
 
18117
18608
  export type CreateArtifactResponse = CreateArtifactResponses[keyof CreateArtifactResponses]
18118
18609
 
@@ -18132,18 +18623,23 @@ export type DeleteArtifactErrors = {
18132
18623
  403: {
18133
18624
  error: string
18134
18625
  /**
18135
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18626
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18136
18627
  */
18137
18628
  code?: string
18138
18629
  /**
18139
- * With artifact_moved: the latest version and who published it
18630
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18140
18631
  */
18141
18632
  latest?: {
18142
18633
  version: number
18634
+ revision: number
18143
18635
  author: {
18144
18636
  type: "user" | "serviceAccount" | "system"
18145
18637
  id: string
18146
18638
  }
18639
+ frozenBy?: {
18640
+ type: "user" | "serviceAccount" | "system"
18641
+ id: string
18642
+ }
18147
18643
  }
18148
18644
  }
18149
18645
  /**
@@ -18152,18 +18648,23 @@ export type DeleteArtifactErrors = {
18152
18648
  404: {
18153
18649
  error: string
18154
18650
  /**
18155
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18651
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18156
18652
  */
18157
18653
  code?: string
18158
18654
  /**
18159
- * With artifact_moved: the latest version and who published it
18655
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18160
18656
  */
18161
18657
  latest?: {
18162
18658
  version: number
18659
+ revision: number
18163
18660
  author: {
18164
18661
  type: "user" | "serviceAccount" | "system"
18165
18662
  id: string
18166
18663
  }
18664
+ frozenBy?: {
18665
+ type: "user" | "serviceAccount" | "system"
18666
+ id: string
18667
+ }
18167
18668
  }
18168
18669
  }
18169
18670
  /**
@@ -18172,18 +18673,23 @@ export type DeleteArtifactErrors = {
18172
18673
  501: {
18173
18674
  error: string
18174
18675
  /**
18175
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18676
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18176
18677
  */
18177
18678
  code?: string
18178
18679
  /**
18179
- * With artifact_moved: the latest version and who published it
18680
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18180
18681
  */
18181
18682
  latest?: {
18182
18683
  version: number
18684
+ revision: number
18183
18685
  author: {
18184
18686
  type: "user" | "serviceAccount" | "system"
18185
18687
  id: string
18186
18688
  }
18689
+ frozenBy?: {
18690
+ type: "user" | "serviceAccount" | "system"
18691
+ id: string
18692
+ }
18187
18693
  }
18188
18694
  }
18189
18695
  }
@@ -18217,18 +18723,23 @@ export type GetArtifactErrors = {
18217
18723
  403: {
18218
18724
  error: string
18219
18725
  /**
18220
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18726
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18221
18727
  */
18222
18728
  code?: string
18223
18729
  /**
18224
- * With artifact_moved: the latest version and who published it
18730
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18225
18731
  */
18226
18732
  latest?: {
18227
18733
  version: number
18734
+ revision: number
18228
18735
  author: {
18229
18736
  type: "user" | "serviceAccount" | "system"
18230
18737
  id: string
18231
18738
  }
18739
+ frozenBy?: {
18740
+ type: "user" | "serviceAccount" | "system"
18741
+ id: string
18742
+ }
18232
18743
  }
18233
18744
  }
18234
18745
  /**
@@ -18237,18 +18748,23 @@ export type GetArtifactErrors = {
18237
18748
  404: {
18238
18749
  error: string
18239
18750
  /**
18240
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18751
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18241
18752
  */
18242
18753
  code?: string
18243
18754
  /**
18244
- * With artifact_moved: the latest version and who published it
18755
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18245
18756
  */
18246
18757
  latest?: {
18247
18758
  version: number
18759
+ revision: number
18248
18760
  author: {
18249
18761
  type: "user" | "serviceAccount" | "system"
18250
18762
  id: string
18251
18763
  }
18764
+ frozenBy?: {
18765
+ type: "user" | "serviceAccount" | "system"
18766
+ id: string
18767
+ }
18252
18768
  }
18253
18769
  }
18254
18770
  /**
@@ -18257,18 +18773,23 @@ export type GetArtifactErrors = {
18257
18773
  501: {
18258
18774
  error: string
18259
18775
  /**
18260
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18776
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18261
18777
  */
18262
18778
  code?: string
18263
18779
  /**
18264
- * With artifact_moved: the latest version and who published it
18780
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18265
18781
  */
18266
18782
  latest?: {
18267
18783
  version: number
18784
+ revision: number
18268
18785
  author: {
18269
18786
  type: "user" | "serviceAccount" | "system"
18270
18787
  id: string
18271
18788
  }
18789
+ frozenBy?: {
18790
+ type: "user" | "serviceAccount" | "system"
18791
+ id: string
18792
+ }
18272
18793
  }
18273
18794
  }
18274
18795
  }
@@ -18290,7 +18811,14 @@ export type GetArtifactResponses = {
18290
18811
  id: string
18291
18812
  }
18292
18813
  latestVersion: number
18814
+ /**
18815
+ * Counts the artifact's changes: a write, a version created, a restore. It only grows, so content read at one revision is that revision's for good
18816
+ */
18817
+ revision: number
18293
18818
  createdAt: string
18819
+ /**
18820
+ * When the artifact last changed
18821
+ */
18294
18822
  updatedAt: string
18295
18823
  }
18296
18824
  /**
@@ -18298,19 +18826,51 @@ export type GetArtifactResponses = {
18298
18826
  */
18299
18827
  versions: Array<{
18300
18828
  version: number
18829
+ /**
18830
+ * The artifact's revision when this version last changed: the latest version's is the artifact's
18831
+ */
18832
+ revision: number
18833
+ /**
18834
+ * Someone created this version: it never changes again. The latest version is open until then, and each write replaces its content
18835
+ */
18836
+ frozen: boolean
18301
18837
  title: string
18838
+ /**
18839
+ * Who last wrote its content
18840
+ */
18302
18841
  author: {
18303
18842
  type: "user" | "serviceAccount" | "system"
18304
18843
  id: string
18305
18844
  }
18845
+ /**
18846
+ * The Agent turn and thread its content was last written from
18847
+ */
18306
18848
  origin?: {
18307
18849
  threadId: string
18308
18850
  runId: string
18309
18851
  }
18852
+ /**
18853
+ * When the version was opened
18854
+ */
18310
18855
  createdAt: string
18856
+ /**
18857
+ * When its content was last written
18858
+ */
18859
+ updatedAt: string
18860
+ /**
18861
+ * When it was created, which froze it
18862
+ */
18863
+ frozenAt?: string
18864
+ /**
18865
+ * Who created it
18866
+ */
18867
+ frozenBy?: {
18868
+ type: "user" | "serviceAccount" | "system"
18869
+ id: string
18870
+ }
18311
18871
  }>
18312
18872
  /**
18313
- * What the caller may do with it: everything as its owner, publish and keep page data as a participant of a conversation that shares it, or only read as an observer of one
18873
+ * What the caller may do with it: everything as its owner, publish and keep page data as a participant of a conversation that shares it or an editor of an object that holds it, or only read as an observer of such a conversation or a reader of such an object
18314
18874
  */
18315
18875
  access: "owner" | "update" | "read"
18316
18876
  }
@@ -18318,6 +18878,125 @@ export type GetArtifactResponses = {
18318
18878
 
18319
18879
  export type GetArtifactResponse = GetArtifactResponses[keyof GetArtifactResponses]
18320
18880
 
18881
+ export type ListArtifactHoldersData = {
18882
+ body?: never
18883
+ path: {
18884
+ artifactId: string
18885
+ }
18886
+ query?: never
18887
+ url: "/api/artifacts/{artifactId}/holders"
18888
+ }
18889
+
18890
+ export type ListArtifactHoldersErrors = {
18891
+ /**
18892
+ * Response for status 403
18893
+ */
18894
+ 403: {
18895
+ error: string
18896
+ /**
18897
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18898
+ */
18899
+ code?: string
18900
+ /**
18901
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18902
+ */
18903
+ latest?: {
18904
+ version: number
18905
+ revision: number
18906
+ author: {
18907
+ type: "user" | "serviceAccount" | "system"
18908
+ id: string
18909
+ }
18910
+ frozenBy?: {
18911
+ type: "user" | "serviceAccount" | "system"
18912
+ id: string
18913
+ }
18914
+ }
18915
+ }
18916
+ /**
18917
+ * Response for status 404
18918
+ */
18919
+ 404: {
18920
+ error: string
18921
+ /**
18922
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18923
+ */
18924
+ code?: string
18925
+ /**
18926
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18927
+ */
18928
+ latest?: {
18929
+ version: number
18930
+ revision: number
18931
+ author: {
18932
+ type: "user" | "serviceAccount" | "system"
18933
+ id: string
18934
+ }
18935
+ frozenBy?: {
18936
+ type: "user" | "serviceAccount" | "system"
18937
+ id: string
18938
+ }
18939
+ }
18940
+ }
18941
+ /**
18942
+ * Response for status 501
18943
+ */
18944
+ 501: {
18945
+ error: string
18946
+ /**
18947
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18948
+ */
18949
+ code?: string
18950
+ /**
18951
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18952
+ */
18953
+ latest?: {
18954
+ version: number
18955
+ revision: number
18956
+ author: {
18957
+ type: "user" | "serviceAccount" | "system"
18958
+ id: string
18959
+ }
18960
+ frozenBy?: {
18961
+ type: "user" | "serviceAccount" | "system"
18962
+ id: string
18963
+ }
18964
+ }
18965
+ }
18966
+ }
18967
+
18968
+ export type ListArtifactHoldersError = ListArtifactHoldersErrors[keyof ListArtifactHoldersErrors]
18969
+
18970
+ export type ListArtifactHoldersResponses = {
18971
+ /**
18972
+ * Response for status 200
18973
+ */
18974
+ 200: {
18975
+ /**
18976
+ * The first 20 objects you read that hold the artifact
18977
+ */
18978
+ holders: Array<{
18979
+ objectTypeId: string
18980
+ primaryId: string
18981
+ /**
18982
+ * The property whose value holds the artifact
18983
+ */
18984
+ propertyId: string
18985
+ /**
18986
+ * The object's value of its type's search title, when it has one you read
18987
+ */
18988
+ title?: string
18989
+ }>
18990
+ /**
18991
+ * More objects you read hold it
18992
+ */
18993
+ hasMore: boolean
18994
+ }
18995
+ }
18996
+
18997
+ export type ListArtifactHoldersResponse =
18998
+ ListArtifactHoldersResponses[keyof ListArtifactHoldersResponses]
18999
+
18321
19000
  export type ClearArtifactStateData = {
18322
19001
  body?: never
18323
19002
  path: {
@@ -18334,18 +19013,23 @@ export type ClearArtifactStateErrors = {
18334
19013
  403: {
18335
19014
  error: string
18336
19015
  /**
18337
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19016
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18338
19017
  */
18339
19018
  code?: string
18340
19019
  /**
18341
- * With artifact_moved: the latest version and who published it
19020
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18342
19021
  */
18343
19022
  latest?: {
18344
19023
  version: number
19024
+ revision: number
18345
19025
  author: {
18346
19026
  type: "user" | "serviceAccount" | "system"
18347
19027
  id: string
18348
19028
  }
19029
+ frozenBy?: {
19030
+ type: "user" | "serviceAccount" | "system"
19031
+ id: string
19032
+ }
18349
19033
  }
18350
19034
  }
18351
19035
  /**
@@ -18354,18 +19038,23 @@ export type ClearArtifactStateErrors = {
18354
19038
  404: {
18355
19039
  error: string
18356
19040
  /**
18357
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19041
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18358
19042
  */
18359
19043
  code?: string
18360
19044
  /**
18361
- * With artifact_moved: the latest version and who published it
19045
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18362
19046
  */
18363
19047
  latest?: {
18364
19048
  version: number
19049
+ revision: number
18365
19050
  author: {
18366
19051
  type: "user" | "serviceAccount" | "system"
18367
19052
  id: string
18368
19053
  }
19054
+ frozenBy?: {
19055
+ type: "user" | "serviceAccount" | "system"
19056
+ id: string
19057
+ }
18369
19058
  }
18370
19059
  }
18371
19060
  /**
@@ -18374,18 +19063,23 @@ export type ClearArtifactStateErrors = {
18374
19063
  501: {
18375
19064
  error: string
18376
19065
  /**
18377
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19066
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18378
19067
  */
18379
19068
  code?: string
18380
19069
  /**
18381
- * With artifact_moved: the latest version and who published it
19070
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18382
19071
  */
18383
19072
  latest?: {
18384
19073
  version: number
19074
+ revision: number
18385
19075
  author: {
18386
19076
  type: "user" | "serviceAccount" | "system"
18387
19077
  id: string
18388
19078
  }
19079
+ frozenBy?: {
19080
+ type: "user" | "serviceAccount" | "system"
19081
+ id: string
19082
+ }
18389
19083
  }
18390
19084
  }
18391
19085
  }
@@ -18423,18 +19117,23 @@ export type GetArtifactStateErrors = {
18423
19117
  403: {
18424
19118
  error: string
18425
19119
  /**
18426
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19120
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18427
19121
  */
18428
19122
  code?: string
18429
19123
  /**
18430
- * With artifact_moved: the latest version and who published it
19124
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18431
19125
  */
18432
19126
  latest?: {
18433
19127
  version: number
19128
+ revision: number
18434
19129
  author: {
18435
19130
  type: "user" | "serviceAccount" | "system"
18436
19131
  id: string
18437
19132
  }
19133
+ frozenBy?: {
19134
+ type: "user" | "serviceAccount" | "system"
19135
+ id: string
19136
+ }
18438
19137
  }
18439
19138
  }
18440
19139
  /**
@@ -18443,18 +19142,23 @@ export type GetArtifactStateErrors = {
18443
19142
  404: {
18444
19143
  error: string
18445
19144
  /**
18446
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19145
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18447
19146
  */
18448
19147
  code?: string
18449
19148
  /**
18450
- * With artifact_moved: the latest version and who published it
19149
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18451
19150
  */
18452
19151
  latest?: {
18453
19152
  version: number
19153
+ revision: number
18454
19154
  author: {
18455
19155
  type: "user" | "serviceAccount" | "system"
18456
19156
  id: string
18457
19157
  }
19158
+ frozenBy?: {
19159
+ type: "user" | "serviceAccount" | "system"
19160
+ id: string
19161
+ }
18458
19162
  }
18459
19163
  }
18460
19164
  /**
@@ -18463,18 +19167,23 @@ export type GetArtifactStateErrors = {
18463
19167
  501: {
18464
19168
  error: string
18465
19169
  /**
18466
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19170
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18467
19171
  */
18468
19172
  code?: string
18469
19173
  /**
18470
- * With artifact_moved: the latest version and who published it
19174
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18471
19175
  */
18472
19176
  latest?: {
18473
19177
  version: number
19178
+ revision: number
18474
19179
  author: {
18475
19180
  type: "user" | "serviceAccount" | "system"
18476
19181
  id: string
18477
19182
  }
19183
+ frozenBy?: {
19184
+ type: "user" | "serviceAccount" | "system"
19185
+ id: string
19186
+ }
18478
19187
  }
18479
19188
  }
18480
19189
  }
@@ -18522,18 +19231,23 @@ export type DeleteArtifactStateValueErrors = {
18522
19231
  400: {
18523
19232
  error: string
18524
19233
  /**
18525
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19234
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18526
19235
  */
18527
19236
  code?: string
18528
19237
  /**
18529
- * With artifact_moved: the latest version and who published it
19238
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18530
19239
  */
18531
19240
  latest?: {
18532
19241
  version: number
19242
+ revision: number
18533
19243
  author: {
18534
19244
  type: "user" | "serviceAccount" | "system"
18535
19245
  id: string
18536
19246
  }
19247
+ frozenBy?: {
19248
+ type: "user" | "serviceAccount" | "system"
19249
+ id: string
19250
+ }
18537
19251
  }
18538
19252
  }
18539
19253
  /**
@@ -18542,18 +19256,23 @@ export type DeleteArtifactStateValueErrors = {
18542
19256
  403: {
18543
19257
  error: string
18544
19258
  /**
18545
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19259
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18546
19260
  */
18547
19261
  code?: string
18548
19262
  /**
18549
- * With artifact_moved: the latest version and who published it
19263
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18550
19264
  */
18551
19265
  latest?: {
18552
19266
  version: number
19267
+ revision: number
18553
19268
  author: {
18554
19269
  type: "user" | "serviceAccount" | "system"
18555
19270
  id: string
18556
19271
  }
19272
+ frozenBy?: {
19273
+ type: "user" | "serviceAccount" | "system"
19274
+ id: string
19275
+ }
18557
19276
  }
18558
19277
  }
18559
19278
  /**
@@ -18562,18 +19281,23 @@ export type DeleteArtifactStateValueErrors = {
18562
19281
  404: {
18563
19282
  error: string
18564
19283
  /**
18565
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19284
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18566
19285
  */
18567
19286
  code?: string
18568
19287
  /**
18569
- * With artifact_moved: the latest version and who published it
19288
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18570
19289
  */
18571
19290
  latest?: {
18572
19291
  version: number
19292
+ revision: number
18573
19293
  author: {
18574
19294
  type: "user" | "serviceAccount" | "system"
18575
19295
  id: string
18576
19296
  }
19297
+ frozenBy?: {
19298
+ type: "user" | "serviceAccount" | "system"
19299
+ id: string
19300
+ }
18577
19301
  }
18578
19302
  }
18579
19303
  /**
@@ -18582,18 +19306,23 @@ export type DeleteArtifactStateValueErrors = {
18582
19306
  501: {
18583
19307
  error: string
18584
19308
  /**
18585
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19309
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18586
19310
  */
18587
19311
  code?: string
18588
19312
  /**
18589
- * With artifact_moved: the latest version and who published it
19313
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18590
19314
  */
18591
19315
  latest?: {
18592
19316
  version: number
19317
+ revision: number
18593
19318
  author: {
18594
19319
  type: "user" | "serviceAccount" | "system"
18595
19320
  id: string
18596
19321
  }
19322
+ frozenBy?: {
19323
+ type: "user" | "serviceAccount" | "system"
19324
+ id: string
19325
+ }
18597
19326
  }
18598
19327
  }
18599
19328
  }
@@ -18638,18 +19367,23 @@ export type SetArtifactStateErrors = {
18638
19367
  400: {
18639
19368
  error: string
18640
19369
  /**
18641
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19370
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18642
19371
  */
18643
19372
  code?: string
18644
19373
  /**
18645
- * With artifact_moved: the latest version and who published it
19374
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18646
19375
  */
18647
19376
  latest?: {
18648
19377
  version: number
19378
+ revision: number
18649
19379
  author: {
18650
19380
  type: "user" | "serviceAccount" | "system"
18651
19381
  id: string
18652
19382
  }
19383
+ frozenBy?: {
19384
+ type: "user" | "serviceAccount" | "system"
19385
+ id: string
19386
+ }
18653
19387
  }
18654
19388
  }
18655
19389
  /**
@@ -18658,18 +19392,23 @@ export type SetArtifactStateErrors = {
18658
19392
  403: {
18659
19393
  error: string
18660
19394
  /**
18661
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19395
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18662
19396
  */
18663
19397
  code?: string
18664
19398
  /**
18665
- * With artifact_moved: the latest version and who published it
19399
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18666
19400
  */
18667
19401
  latest?: {
18668
19402
  version: number
19403
+ revision: number
18669
19404
  author: {
18670
19405
  type: "user" | "serviceAccount" | "system"
18671
19406
  id: string
18672
19407
  }
19408
+ frozenBy?: {
19409
+ type: "user" | "serviceAccount" | "system"
19410
+ id: string
19411
+ }
18673
19412
  }
18674
19413
  }
18675
19414
  /**
@@ -18678,18 +19417,23 @@ export type SetArtifactStateErrors = {
18678
19417
  404: {
18679
19418
  error: string
18680
19419
  /**
18681
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19420
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18682
19421
  */
18683
19422
  code?: string
18684
19423
  /**
18685
- * With artifact_moved: the latest version and who published it
19424
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18686
19425
  */
18687
19426
  latest?: {
18688
19427
  version: number
19428
+ revision: number
18689
19429
  author: {
18690
19430
  type: "user" | "serviceAccount" | "system"
18691
19431
  id: string
18692
19432
  }
19433
+ frozenBy?: {
19434
+ type: "user" | "serviceAccount" | "system"
19435
+ id: string
19436
+ }
18693
19437
  }
18694
19438
  }
18695
19439
  /**
@@ -18698,18 +19442,23 @@ export type SetArtifactStateErrors = {
18698
19442
  413: {
18699
19443
  error: string
18700
19444
  /**
18701
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19445
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18702
19446
  */
18703
19447
  code?: string
18704
19448
  /**
18705
- * With artifact_moved: the latest version and who published it
19449
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18706
19450
  */
18707
19451
  latest?: {
18708
19452
  version: number
19453
+ revision: number
18709
19454
  author: {
18710
19455
  type: "user" | "serviceAccount" | "system"
18711
19456
  id: string
18712
19457
  }
19458
+ frozenBy?: {
19459
+ type: "user" | "serviceAccount" | "system"
19460
+ id: string
19461
+ }
18713
19462
  }
18714
19463
  }
18715
19464
  /**
@@ -18718,18 +19467,23 @@ export type SetArtifactStateErrors = {
18718
19467
  501: {
18719
19468
  error: string
18720
19469
  /**
18721
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19470
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18722
19471
  */
18723
19472
  code?: string
18724
19473
  /**
18725
- * With artifact_moved: the latest version and who published it
19474
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18726
19475
  */
18727
19476
  latest?: {
18728
19477
  version: number
19478
+ revision: number
18729
19479
  author: {
18730
19480
  type: "user" | "serviceAccount" | "system"
18731
19481
  id: string
18732
19482
  }
19483
+ frozenBy?: {
19484
+ type: "user" | "serviceAccount" | "system"
19485
+ id: string
19486
+ }
18733
19487
  }
18734
19488
  }
18735
19489
  }
@@ -18752,7 +19506,7 @@ export type SetArtifactStateResponses = {
18752
19506
 
18753
19507
  export type SetArtifactStateResponse = SetArtifactStateResponses[keyof SetArtifactStateResponses]
18754
19508
 
18755
- export type PublishArtifactVersionData = {
19509
+ export type UpdateArtifactData = {
18756
19510
  body: {
18757
19511
  kind: "document" | "sheet" | "slides" | "page" | "canvas" | "file"
18758
19512
  title: string
@@ -18774,36 +19528,41 @@ export type PublishArtifactVersionData = {
18774
19528
  }
18775
19529
  }>
18776
19530
  /**
18777
- * The version this one was made from. When another was published since, the publish is refused with 409 artifact_moved, naming the latest version.
19531
+ * The revision this was made from. When the artifact changed since, it is refused with 409 artifact_moved, naming the revision and who last wrote the latest version.
18778
19532
  */
18779
- baseVersion?: number
19533
+ baseRevision?: number
18780
19534
  }
18781
19535
  path: {
18782
19536
  artifactId: string
18783
19537
  }
18784
19538
  query?: never
18785
- url: "/api/artifacts/{artifactId}/versions"
19539
+ url: "/api/artifacts/{artifactId}/content"
18786
19540
  }
18787
19541
 
18788
- export type PublishArtifactVersionErrors = {
19542
+ export type UpdateArtifactErrors = {
18789
19543
  /**
18790
19544
  * Response for status 400
18791
19545
  */
18792
19546
  400: {
18793
19547
  error: string
18794
19548
  /**
18795
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19549
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18796
19550
  */
18797
19551
  code?: string
18798
19552
  /**
18799
- * With artifact_moved: the latest version and who published it
19553
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18800
19554
  */
18801
19555
  latest?: {
18802
19556
  version: number
19557
+ revision: number
18803
19558
  author: {
18804
19559
  type: "user" | "serviceAccount" | "system"
18805
19560
  id: string
18806
19561
  }
19562
+ frozenBy?: {
19563
+ type: "user" | "serviceAccount" | "system"
19564
+ id: string
19565
+ }
18807
19566
  }
18808
19567
  }
18809
19568
  /**
@@ -18812,18 +19571,23 @@ export type PublishArtifactVersionErrors = {
18812
19571
  403: {
18813
19572
  error: string
18814
19573
  /**
18815
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19574
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18816
19575
  */
18817
19576
  code?: string
18818
19577
  /**
18819
- * With artifact_moved: the latest version and who published it
19578
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18820
19579
  */
18821
19580
  latest?: {
18822
19581
  version: number
19582
+ revision: number
18823
19583
  author: {
18824
19584
  type: "user" | "serviceAccount" | "system"
18825
19585
  id: string
18826
19586
  }
19587
+ frozenBy?: {
19588
+ type: "user" | "serviceAccount" | "system"
19589
+ id: string
19590
+ }
18827
19591
  }
18828
19592
  }
18829
19593
  /**
@@ -18832,18 +19596,23 @@ export type PublishArtifactVersionErrors = {
18832
19596
  404: {
18833
19597
  error: string
18834
19598
  /**
18835
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19599
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18836
19600
  */
18837
19601
  code?: string
18838
19602
  /**
18839
- * With artifact_moved: the latest version and who published it
19603
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18840
19604
  */
18841
19605
  latest?: {
18842
19606
  version: number
19607
+ revision: number
18843
19608
  author: {
18844
19609
  type: "user" | "serviceAccount" | "system"
18845
19610
  id: string
18846
19611
  }
19612
+ frozenBy?: {
19613
+ type: "user" | "serviceAccount" | "system"
19614
+ id: string
19615
+ }
18847
19616
  }
18848
19617
  }
18849
19618
  /**
@@ -18852,18 +19621,23 @@ export type PublishArtifactVersionErrors = {
18852
19621
  409: {
18853
19622
  error: string
18854
19623
  /**
18855
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19624
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18856
19625
  */
18857
19626
  code?: string
18858
19627
  /**
18859
- * With artifact_moved: the latest version and who published it
19628
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18860
19629
  */
18861
19630
  latest?: {
18862
19631
  version: number
19632
+ revision: number
18863
19633
  author: {
18864
19634
  type: "user" | "serviceAccount" | "system"
18865
19635
  id: string
18866
19636
  }
19637
+ frozenBy?: {
19638
+ type: "user" | "serviceAccount" | "system"
19639
+ id: string
19640
+ }
18867
19641
  }
18868
19642
  }
18869
19643
  /**
@@ -18872,30 +19646,34 @@ export type PublishArtifactVersionErrors = {
18872
19646
  501: {
18873
19647
  error: string
18874
19648
  /**
18875
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19649
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
18876
19650
  */
18877
19651
  code?: string
18878
19652
  /**
18879
- * With artifact_moved: the latest version and who published it
19653
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
18880
19654
  */
18881
19655
  latest?: {
18882
19656
  version: number
19657
+ revision: number
18883
19658
  author: {
18884
19659
  type: "user" | "serviceAccount" | "system"
18885
19660
  id: string
18886
19661
  }
19662
+ frozenBy?: {
19663
+ type: "user" | "serviceAccount" | "system"
19664
+ id: string
19665
+ }
18887
19666
  }
18888
19667
  }
18889
19668
  }
18890
19669
 
18891
- export type PublishArtifactVersionError =
18892
- PublishArtifactVersionErrors[keyof PublishArtifactVersionErrors]
19670
+ export type UpdateArtifactError = UpdateArtifactErrors[keyof UpdateArtifactErrors]
18893
19671
 
18894
- export type PublishArtifactVersionResponses = {
19672
+ export type UpdateArtifactResponses = {
18895
19673
  /**
18896
- * Response for status 201
19674
+ * Response for status 200
18897
19675
  */
18898
- 201: {
19676
+ 200: {
18899
19677
  artifact: {
18900
19678
  id: string
18901
19679
  projectId: string
@@ -18906,12 +19684,1819 @@ export type PublishArtifactVersionResponses = {
18906
19684
  id: string
18907
19685
  }
18908
19686
  latestVersion: number
19687
+ /**
19688
+ * Counts the artifact's changes: a write, a version created, a restore. It only grows, so content read at one revision is that revision's for good
19689
+ */
19690
+ revision: number
18909
19691
  createdAt: string
19692
+ /**
19693
+ * When the artifact last changed
19694
+ */
19695
+ updatedAt: string
19696
+ }
19697
+ version: {
19698
+ artifactId: string
19699
+ version: number
19700
+ /**
19701
+ * The artifact's revision when this version last changed: the latest version's is the artifact's
19702
+ */
19703
+ revision: number
19704
+ /**
19705
+ * Someone created this version: it never changes again. The latest version is open until then, and each write replaces its content
19706
+ */
19707
+ frozen: boolean
19708
+ title: string
19709
+ entry: string
19710
+ files: Array<{
19711
+ /**
19712
+ * The file's path inside the artifact, such as figures/revenue.svg
19713
+ */
19714
+ path: string
19715
+ file: {
19716
+ blobId: string
19717
+ digest: string
19718
+ sizeBytes: number
19719
+ fileName?: string
19720
+ mediaType?: string
19721
+ logicalPath?: string
19722
+ }
19723
+ }>
19724
+ outline:
19725
+ | {
19726
+ kind: "document"
19727
+ headings: Array<{
19728
+ depth: number
19729
+ text: string
19730
+ slug: string
19731
+ }>
19732
+ }
19733
+ | {
19734
+ kind: "sheet"
19735
+ sheets: Array<{
19736
+ name: string
19737
+ /**
19738
+ * The rows of its CSV; none for a live sheet
19739
+ */
19740
+ rows: number
19741
+ columns: Array<string>
19742
+ /**
19743
+ * A live sheet's query, queries/<name>.json, whose rows each reader reads
19744
+ */
19745
+ query?: string
19746
+ }>
19747
+ charts: Array<string>
19748
+ }
19749
+ | {
19750
+ kind: "slides"
19751
+ slides: Array<{
19752
+ title?: string
19753
+ }>
19754
+ }
19755
+ | {
19756
+ kind: "page"
19757
+ title?: string
19758
+ }
19759
+ | {
19760
+ kind: "canvas"
19761
+ items: Array<
19762
+ | {
19763
+ id: string
19764
+ type: "board"
19765
+ title?: string
19766
+ file: string
19767
+ w: number
19768
+ h: number
19769
+ /**
19770
+ * What the board's preview is a picture of: a board kept as it was keeps it
19771
+ */
19772
+ renderKey?: string
19773
+ }
19774
+ | {
19775
+ id: string
19776
+ type: "section"
19777
+ title?: string
19778
+ }
19779
+ >
19780
+ /**
19781
+ * The modes each board has a preview in: both, or the one its theme.json pins
19782
+ */
19783
+ themes?: Array<"light" | "dark">
19784
+ }
19785
+ | {
19786
+ kind: "file"
19787
+ mediaType: string
19788
+ }
19789
+ references: Array<{
19790
+ address: string
19791
+ as: "embed" | "link"
19792
+ at: string
19793
+ resolvedVersion: number
19794
+ }>
19795
+ /**
19796
+ * Who last wrote its content
19797
+ */
19798
+ author: {
19799
+ type: "user" | "serviceAccount" | "system"
19800
+ id: string
19801
+ }
19802
+ /**
19803
+ * The Agent turn and thread its content was last written from
19804
+ */
19805
+ origin?: {
19806
+ threadId: string
19807
+ runId: string
19808
+ }
19809
+ /**
19810
+ * When the version was opened
19811
+ */
19812
+ createdAt: string
19813
+ /**
19814
+ * When its content was last written
19815
+ */
19816
+ updatedAt: string
19817
+ /**
19818
+ * When it was created, which froze it
19819
+ */
19820
+ frozenAt?: string
19821
+ /**
19822
+ * Who created it
19823
+ */
19824
+ frozenBy?: {
19825
+ type: "user" | "serviceAccount" | "system"
19826
+ id: string
19827
+ }
19828
+ /**
19829
+ * A canvas's boards by id, as reading or publishing the version returns them: ready when its preview is, pending while it is rendered, none when none will come and the board shows its outline
19830
+ */
19831
+ boardPreviews?: {
19832
+ [key: string]: "ready" | "pending" | "none"
19833
+ }
19834
+ }
19835
+ warnings: Array<{
19836
+ code: string
19837
+ message: string
19838
+ part?: string
19839
+ }>
19840
+ }
19841
+ }
19842
+
19843
+ export type UpdateArtifactResponse = UpdateArtifactResponses[keyof UpdateArtifactResponses]
19844
+
19845
+ export type FreezeArtifactVersionData = {
19846
+ body: {
19847
+ /**
19848
+ * The revision this was made from. When the artifact changed since, it is refused with 409 artifact_moved, naming the revision and who last wrote the latest version.
19849
+ */
19850
+ baseRevision?: number
19851
+ }
19852
+ path: {
19853
+ artifactId: string
19854
+ }
19855
+ query?: never
19856
+ url: "/api/artifacts/{artifactId}/freeze"
19857
+ }
19858
+
19859
+ export type FreezeArtifactVersionErrors = {
19860
+ /**
19861
+ * Response for status 400
19862
+ */
19863
+ 400: {
19864
+ error: string
19865
+ /**
19866
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19867
+ */
19868
+ code?: string
19869
+ /**
19870
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
19871
+ */
19872
+ latest?: {
19873
+ version: number
19874
+ revision: number
19875
+ author: {
19876
+ type: "user" | "serviceAccount" | "system"
19877
+ id: string
19878
+ }
19879
+ frozenBy?: {
19880
+ type: "user" | "serviceAccount" | "system"
19881
+ id: string
19882
+ }
19883
+ }
19884
+ }
19885
+ /**
19886
+ * Response for status 403
19887
+ */
19888
+ 403: {
19889
+ error: string
19890
+ /**
19891
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19892
+ */
19893
+ code?: string
19894
+ /**
19895
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
19896
+ */
19897
+ latest?: {
19898
+ version: number
19899
+ revision: number
19900
+ author: {
19901
+ type: "user" | "serviceAccount" | "system"
19902
+ id: string
19903
+ }
19904
+ frozenBy?: {
19905
+ type: "user" | "serviceAccount" | "system"
19906
+ id: string
19907
+ }
19908
+ }
19909
+ }
19910
+ /**
19911
+ * Response for status 404
19912
+ */
19913
+ 404: {
19914
+ error: string
19915
+ /**
19916
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19917
+ */
19918
+ code?: string
19919
+ /**
19920
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
19921
+ */
19922
+ latest?: {
19923
+ version: number
19924
+ revision: number
19925
+ author: {
19926
+ type: "user" | "serviceAccount" | "system"
19927
+ id: string
19928
+ }
19929
+ frozenBy?: {
19930
+ type: "user" | "serviceAccount" | "system"
19931
+ id: string
19932
+ }
19933
+ }
19934
+ }
19935
+ /**
19936
+ * Response for status 409
19937
+ */
19938
+ 409: {
19939
+ error: string
19940
+ /**
19941
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19942
+ */
19943
+ code?: string
19944
+ /**
19945
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
19946
+ */
19947
+ latest?: {
19948
+ version: number
19949
+ revision: number
19950
+ author: {
19951
+ type: "user" | "serviceAccount" | "system"
19952
+ id: string
19953
+ }
19954
+ frozenBy?: {
19955
+ type: "user" | "serviceAccount" | "system"
19956
+ id: string
19957
+ }
19958
+ }
19959
+ }
19960
+ /**
19961
+ * Response for status 501
19962
+ */
19963
+ 501: {
19964
+ error: string
19965
+ /**
19966
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19967
+ */
19968
+ code?: string
19969
+ /**
19970
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
19971
+ */
19972
+ latest?: {
19973
+ version: number
19974
+ revision: number
19975
+ author: {
19976
+ type: "user" | "serviceAccount" | "system"
19977
+ id: string
19978
+ }
19979
+ frozenBy?: {
19980
+ type: "user" | "serviceAccount" | "system"
19981
+ id: string
19982
+ }
19983
+ }
19984
+ }
19985
+ }
19986
+
19987
+ export type FreezeArtifactVersionError =
19988
+ FreezeArtifactVersionErrors[keyof FreezeArtifactVersionErrors]
19989
+
19990
+ export type FreezeArtifactVersionResponses = {
19991
+ /**
19992
+ * Response for status 200
19993
+ */
19994
+ 200: {
19995
+ artifact: {
19996
+ id: string
19997
+ projectId: string
19998
+ kind: "document" | "sheet" | "slides" | "page" | "canvas" | "file"
19999
+ title: string
20000
+ owner: {
20001
+ type: "user" | "serviceAccount" | "system"
20002
+ id: string
20003
+ }
20004
+ latestVersion: number
20005
+ /**
20006
+ * Counts the artifact's changes: a write, a version created, a restore. It only grows, so content read at one revision is that revision's for good
20007
+ */
20008
+ revision: number
20009
+ createdAt: string
20010
+ /**
20011
+ * When the artifact last changed
20012
+ */
20013
+ updatedAt: string
20014
+ }
20015
+ version: {
20016
+ artifactId: string
20017
+ version: number
20018
+ /**
20019
+ * The artifact's revision when this version last changed: the latest version's is the artifact's
20020
+ */
20021
+ revision: number
20022
+ /**
20023
+ * Someone created this version: it never changes again. The latest version is open until then, and each write replaces its content
20024
+ */
20025
+ frozen: boolean
20026
+ title: string
20027
+ entry: string
20028
+ files: Array<{
20029
+ /**
20030
+ * The file's path inside the artifact, such as figures/revenue.svg
20031
+ */
20032
+ path: string
20033
+ file: {
20034
+ blobId: string
20035
+ digest: string
20036
+ sizeBytes: number
20037
+ fileName?: string
20038
+ mediaType?: string
20039
+ logicalPath?: string
20040
+ }
20041
+ }>
20042
+ outline:
20043
+ | {
20044
+ kind: "document"
20045
+ headings: Array<{
20046
+ depth: number
20047
+ text: string
20048
+ slug: string
20049
+ }>
20050
+ }
20051
+ | {
20052
+ kind: "sheet"
20053
+ sheets: Array<{
20054
+ name: string
20055
+ /**
20056
+ * The rows of its CSV; none for a live sheet
20057
+ */
20058
+ rows: number
20059
+ columns: Array<string>
20060
+ /**
20061
+ * A live sheet's query, queries/<name>.json, whose rows each reader reads
20062
+ */
20063
+ query?: string
20064
+ }>
20065
+ charts: Array<string>
20066
+ }
20067
+ | {
20068
+ kind: "slides"
20069
+ slides: Array<{
20070
+ title?: string
20071
+ }>
20072
+ }
20073
+ | {
20074
+ kind: "page"
20075
+ title?: string
20076
+ }
20077
+ | {
20078
+ kind: "canvas"
20079
+ items: Array<
20080
+ | {
20081
+ id: string
20082
+ type: "board"
20083
+ title?: string
20084
+ file: string
20085
+ w: number
20086
+ h: number
20087
+ /**
20088
+ * What the board's preview is a picture of: a board kept as it was keeps it
20089
+ */
20090
+ renderKey?: string
20091
+ }
20092
+ | {
20093
+ id: string
20094
+ type: "section"
20095
+ title?: string
20096
+ }
20097
+ >
20098
+ /**
20099
+ * The modes each board has a preview in: both, or the one its theme.json pins
20100
+ */
20101
+ themes?: Array<"light" | "dark">
20102
+ }
20103
+ | {
20104
+ kind: "file"
20105
+ mediaType: string
20106
+ }
20107
+ references: Array<{
20108
+ address: string
20109
+ as: "embed" | "link"
20110
+ at: string
20111
+ resolvedVersion: number
20112
+ }>
20113
+ /**
20114
+ * Who last wrote its content
20115
+ */
20116
+ author: {
20117
+ type: "user" | "serviceAccount" | "system"
20118
+ id: string
20119
+ }
20120
+ /**
20121
+ * The Agent turn and thread its content was last written from
20122
+ */
20123
+ origin?: {
20124
+ threadId: string
20125
+ runId: string
20126
+ }
20127
+ /**
20128
+ * When the version was opened
20129
+ */
20130
+ createdAt: string
20131
+ /**
20132
+ * When its content was last written
20133
+ */
20134
+ updatedAt: string
20135
+ /**
20136
+ * When it was created, which froze it
20137
+ */
20138
+ frozenAt?: string
20139
+ /**
20140
+ * Who created it
20141
+ */
20142
+ frozenBy?: {
20143
+ type: "user" | "serviceAccount" | "system"
20144
+ id: string
20145
+ }
20146
+ /**
20147
+ * A canvas's boards by id, as reading or publishing the version returns them: ready when its preview is, pending while it is rendered, none when none will come and the board shows its outline
20148
+ */
20149
+ boardPreviews?: {
20150
+ [key: string]: "ready" | "pending" | "none"
20151
+ }
20152
+ }
20153
+ }
20154
+ }
20155
+
20156
+ export type FreezeArtifactVersionResponse =
20157
+ FreezeArtifactVersionResponses[keyof FreezeArtifactVersionResponses]
20158
+
20159
+ export type ListArtifactCommentsData = {
20160
+ body?: never
20161
+ path: {
20162
+ artifactId: string
20163
+ }
20164
+ query?: never
20165
+ url: "/api/artifacts/{artifactId}/comments"
20166
+ }
20167
+
20168
+ export type ListArtifactCommentsErrors = {
20169
+ /**
20170
+ * Response for status 403
20171
+ */
20172
+ 403: {
20173
+ error: string
20174
+ /**
20175
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20176
+ */
20177
+ code?: string
20178
+ /**
20179
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20180
+ */
20181
+ latest?: {
20182
+ version: number
20183
+ revision: number
20184
+ author: {
20185
+ type: "user" | "serviceAccount" | "system"
20186
+ id: string
20187
+ }
20188
+ frozenBy?: {
20189
+ type: "user" | "serviceAccount" | "system"
20190
+ id: string
20191
+ }
20192
+ }
20193
+ }
20194
+ /**
20195
+ * Response for status 404
20196
+ */
20197
+ 404: {
20198
+ error: string
20199
+ /**
20200
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20201
+ */
20202
+ code?: string
20203
+ /**
20204
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20205
+ */
20206
+ latest?: {
20207
+ version: number
20208
+ revision: number
20209
+ author: {
20210
+ type: "user" | "serviceAccount" | "system"
20211
+ id: string
20212
+ }
20213
+ frozenBy?: {
20214
+ type: "user" | "serviceAccount" | "system"
20215
+ id: string
20216
+ }
20217
+ }
20218
+ }
20219
+ /**
20220
+ * Response for status 501
20221
+ */
20222
+ 501: {
20223
+ error: string
20224
+ /**
20225
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20226
+ */
20227
+ code?: string
20228
+ /**
20229
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20230
+ */
20231
+ latest?: {
20232
+ version: number
20233
+ revision: number
20234
+ author: {
20235
+ type: "user" | "serviceAccount" | "system"
20236
+ id: string
20237
+ }
20238
+ frozenBy?: {
20239
+ type: "user" | "serviceAccount" | "system"
20240
+ id: string
20241
+ }
20242
+ }
20243
+ }
20244
+ }
20245
+
20246
+ export type ListArtifactCommentsError = ListArtifactCommentsErrors[keyof ListArtifactCommentsErrors]
20247
+
20248
+ export type ListArtifactCommentsResponses = {
20249
+ /**
20250
+ * Response for status 200
20251
+ */
20252
+ 200: {
20253
+ /**
20254
+ * Comments and replies, oldest first
20255
+ */
20256
+ comments: Array<{
20257
+ artifactId: string
20258
+ id: string
20259
+ /**
20260
+ * The comment it replies to, for a reply
20261
+ */
20262
+ parentId?: string
20263
+ anchor: {
20264
+ /**
20265
+ * The id of the canvas's board it is about
20266
+ */
20267
+ board?: string
20268
+ /**
20269
+ * The address of the board's element it is about, such as body>main:0>h1:0
20270
+ */
20271
+ element?: string
20272
+ /**
20273
+ * The element's first words, which name it once it is gone; kept to 120 characters
20274
+ */
20275
+ label?: string
20276
+ /**
20277
+ * Where on the board its pin is, as fractions of the board's width and height from its top left
20278
+ */
20279
+ point?: {
20280
+ x: number
20281
+ y: number
20282
+ }
20283
+ /**
20284
+ * The artifact's revision its author saw
20285
+ */
20286
+ revision: number
20287
+ }
20288
+ /**
20289
+ * Plain text
20290
+ */
20291
+ body: string
20292
+ /**
20293
+ * Who wrote it: a principal, or a guest, someone without an account who opened a shared link, whose id is their link's session
20294
+ */
20295
+ author: {
20296
+ type: "user" | "serviceAccount" | "system" | "guest"
20297
+ id: string
20298
+ }
20299
+ /**
20300
+ * Its author's name: a member's profile name or email, the project's for its own code, or the name a guest gave; null for anyone the project cannot name. A guest reading it never gets a member's email
20301
+ */
20302
+ authorName: string | null
20303
+ /**
20304
+ * The Agent's run that wrote it for its author, and that run's conversation
20305
+ */
20306
+ origin?: {
20307
+ threadId: string
20308
+ runId: string
20309
+ }
20310
+ createdAt: string
20311
+ /**
20312
+ * When someone marked it resolved
20313
+ */
20314
+ resolvedAt?: string
20315
+ /**
20316
+ * Who marked it resolved
20317
+ */
20318
+ resolvedBy?: {
20319
+ type: "user" | "serviceAccount" | "system"
20320
+ id: string
20321
+ }
20322
+ }>
20323
+ }
20324
+ }
20325
+
20326
+ export type ListArtifactCommentsResponse =
20327
+ ListArtifactCommentsResponses[keyof ListArtifactCommentsResponses]
20328
+
20329
+ export type AddArtifactCommentData = {
20330
+ body: {
20331
+ /**
20332
+ * Plain text
20333
+ */
20334
+ body: string
20335
+ /**
20336
+ * What it is about: a board, an element of the board, or, without, the artifact; at the artifact's revision by default. A reply is about what it replies to.
20337
+ */
20338
+ anchor?: {
20339
+ /**
20340
+ * The id of the canvas's board it is about
20341
+ */
20342
+ board?: string
20343
+ /**
20344
+ * The address of the board's element it is about, such as body>main:0>h1:0
20345
+ */
20346
+ element?: string
20347
+ /**
20348
+ * The element's first words, which name it once it is gone; kept to 120 characters
20349
+ */
20350
+ label?: string
20351
+ /**
20352
+ * Where on the board its pin is, as fractions of the board's width and height from its top left
20353
+ */
20354
+ point?: {
20355
+ x: number
20356
+ y: number
20357
+ }
20358
+ /**
20359
+ * The artifact's revision its author saw
20360
+ */
20361
+ revision?: number
20362
+ }
20363
+ /**
20364
+ * The comment it replies to
20365
+ */
20366
+ parentId?: string
20367
+ }
20368
+ path: {
20369
+ artifactId: string
20370
+ }
20371
+ query?: never
20372
+ url: "/api/artifacts/{artifactId}/comments"
20373
+ }
20374
+
20375
+ export type AddArtifactCommentErrors = {
20376
+ /**
20377
+ * Response for status 400
20378
+ */
20379
+ 400: {
20380
+ error: string
20381
+ /**
20382
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20383
+ */
20384
+ code?: string
20385
+ /**
20386
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20387
+ */
20388
+ latest?: {
20389
+ version: number
20390
+ revision: number
20391
+ author: {
20392
+ type: "user" | "serviceAccount" | "system"
20393
+ id: string
20394
+ }
20395
+ frozenBy?: {
20396
+ type: "user" | "serviceAccount" | "system"
20397
+ id: string
20398
+ }
20399
+ }
20400
+ }
20401
+ /**
20402
+ * Response for status 403
20403
+ */
20404
+ 403: {
20405
+ error: string
20406
+ /**
20407
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20408
+ */
20409
+ code?: string
20410
+ /**
20411
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20412
+ */
20413
+ latest?: {
20414
+ version: number
20415
+ revision: number
20416
+ author: {
20417
+ type: "user" | "serviceAccount" | "system"
20418
+ id: string
20419
+ }
20420
+ frozenBy?: {
20421
+ type: "user" | "serviceAccount" | "system"
20422
+ id: string
20423
+ }
20424
+ }
20425
+ }
20426
+ /**
20427
+ * Response for status 404
20428
+ */
20429
+ 404: {
20430
+ error: string
20431
+ /**
20432
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20433
+ */
20434
+ code?: string
20435
+ /**
20436
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20437
+ */
20438
+ latest?: {
20439
+ version: number
20440
+ revision: number
20441
+ author: {
20442
+ type: "user" | "serviceAccount" | "system"
20443
+ id: string
20444
+ }
20445
+ frozenBy?: {
20446
+ type: "user" | "serviceAccount" | "system"
20447
+ id: string
20448
+ }
20449
+ }
20450
+ }
20451
+ /**
20452
+ * Response for status 413
20453
+ */
20454
+ 413: {
20455
+ error: string
20456
+ /**
20457
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20458
+ */
20459
+ code?: string
20460
+ /**
20461
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20462
+ */
20463
+ latest?: {
20464
+ version: number
20465
+ revision: number
20466
+ author: {
20467
+ type: "user" | "serviceAccount" | "system"
20468
+ id: string
20469
+ }
20470
+ frozenBy?: {
20471
+ type: "user" | "serviceAccount" | "system"
20472
+ id: string
20473
+ }
20474
+ }
20475
+ }
20476
+ /**
20477
+ * Response for status 501
20478
+ */
20479
+ 501: {
20480
+ error: string
20481
+ /**
20482
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20483
+ */
20484
+ code?: string
20485
+ /**
20486
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20487
+ */
20488
+ latest?: {
20489
+ version: number
20490
+ revision: number
20491
+ author: {
20492
+ type: "user" | "serviceAccount" | "system"
20493
+ id: string
20494
+ }
20495
+ frozenBy?: {
20496
+ type: "user" | "serviceAccount" | "system"
20497
+ id: string
20498
+ }
20499
+ }
20500
+ }
20501
+ }
20502
+
20503
+ export type AddArtifactCommentError = AddArtifactCommentErrors[keyof AddArtifactCommentErrors]
20504
+
20505
+ export type AddArtifactCommentResponses = {
20506
+ /**
20507
+ * Response for status 201
20508
+ */
20509
+ 201: {
20510
+ artifactId: string
20511
+ id: string
20512
+ /**
20513
+ * The comment it replies to, for a reply
20514
+ */
20515
+ parentId?: string
20516
+ anchor: {
20517
+ /**
20518
+ * The id of the canvas's board it is about
20519
+ */
20520
+ board?: string
20521
+ /**
20522
+ * The address of the board's element it is about, such as body>main:0>h1:0
20523
+ */
20524
+ element?: string
20525
+ /**
20526
+ * The element's first words, which name it once it is gone; kept to 120 characters
20527
+ */
20528
+ label?: string
20529
+ /**
20530
+ * Where on the board its pin is, as fractions of the board's width and height from its top left
20531
+ */
20532
+ point?: {
20533
+ x: number
20534
+ y: number
20535
+ }
20536
+ /**
20537
+ * The artifact's revision its author saw
20538
+ */
20539
+ revision: number
20540
+ }
20541
+ /**
20542
+ * Plain text
20543
+ */
20544
+ body: string
20545
+ /**
20546
+ * Who wrote it: a principal, or a guest, someone without an account who opened a shared link, whose id is their link's session
20547
+ */
20548
+ author: {
20549
+ type: "user" | "serviceAccount" | "system" | "guest"
20550
+ id: string
20551
+ }
20552
+ /**
20553
+ * Its author's name: a member's profile name or email, the project's for its own code, or the name a guest gave; null for anyone the project cannot name. A guest reading it never gets a member's email
20554
+ */
20555
+ authorName: string | null
20556
+ /**
20557
+ * The Agent's run that wrote it for its author, and that run's conversation
20558
+ */
20559
+ origin?: {
20560
+ threadId: string
20561
+ runId: string
20562
+ }
20563
+ createdAt: string
20564
+ /**
20565
+ * When someone marked it resolved
20566
+ */
20567
+ resolvedAt?: string
20568
+ /**
20569
+ * Who marked it resolved
20570
+ */
20571
+ resolvedBy?: {
20572
+ type: "user" | "serviceAccount" | "system"
20573
+ id: string
20574
+ }
20575
+ }
20576
+ }
20577
+
20578
+ export type AddArtifactCommentResponse =
20579
+ AddArtifactCommentResponses[keyof AddArtifactCommentResponses]
20580
+
20581
+ export type ResolveArtifactCommentData = {
20582
+ body: {
20583
+ /**
20584
+ * False opens it again
20585
+ */
20586
+ resolved?: boolean
20587
+ }
20588
+ path: {
20589
+ artifactId: string
20590
+ commentId: string
20591
+ }
20592
+ query?: never
20593
+ url: "/api/artifacts/{artifactId}/comments/{commentId}/resolve"
20594
+ }
20595
+
20596
+ export type ResolveArtifactCommentErrors = {
20597
+ /**
20598
+ * Response for status 400
20599
+ */
20600
+ 400: {
20601
+ error: string
20602
+ /**
20603
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20604
+ */
20605
+ code?: string
20606
+ /**
20607
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20608
+ */
20609
+ latest?: {
20610
+ version: number
20611
+ revision: number
20612
+ author: {
20613
+ type: "user" | "serviceAccount" | "system"
20614
+ id: string
20615
+ }
20616
+ frozenBy?: {
20617
+ type: "user" | "serviceAccount" | "system"
20618
+ id: string
20619
+ }
20620
+ }
20621
+ }
20622
+ /**
20623
+ * Response for status 403
20624
+ */
20625
+ 403: {
20626
+ error: string
20627
+ /**
20628
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20629
+ */
20630
+ code?: string
20631
+ /**
20632
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20633
+ */
20634
+ latest?: {
20635
+ version: number
20636
+ revision: number
20637
+ author: {
20638
+ type: "user" | "serviceAccount" | "system"
20639
+ id: string
20640
+ }
20641
+ frozenBy?: {
20642
+ type: "user" | "serviceAccount" | "system"
20643
+ id: string
20644
+ }
20645
+ }
20646
+ }
20647
+ /**
20648
+ * Response for status 404
20649
+ */
20650
+ 404: {
20651
+ error: string
20652
+ /**
20653
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20654
+ */
20655
+ code?: string
20656
+ /**
20657
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20658
+ */
20659
+ latest?: {
20660
+ version: number
20661
+ revision: number
20662
+ author: {
20663
+ type: "user" | "serviceAccount" | "system"
20664
+ id: string
20665
+ }
20666
+ frozenBy?: {
20667
+ type: "user" | "serviceAccount" | "system"
20668
+ id: string
20669
+ }
20670
+ }
20671
+ }
20672
+ /**
20673
+ * Response for status 501
20674
+ */
20675
+ 501: {
20676
+ error: string
20677
+ /**
20678
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20679
+ */
20680
+ code?: string
20681
+ /**
20682
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20683
+ */
20684
+ latest?: {
20685
+ version: number
20686
+ revision: number
20687
+ author: {
20688
+ type: "user" | "serviceAccount" | "system"
20689
+ id: string
20690
+ }
20691
+ frozenBy?: {
20692
+ type: "user" | "serviceAccount" | "system"
20693
+ id: string
20694
+ }
20695
+ }
20696
+ }
20697
+ }
20698
+
20699
+ export type ResolveArtifactCommentError =
20700
+ ResolveArtifactCommentErrors[keyof ResolveArtifactCommentErrors]
20701
+
20702
+ export type ResolveArtifactCommentResponses = {
20703
+ /**
20704
+ * Response for status 200
20705
+ */
20706
+ 200: {
20707
+ artifactId: string
20708
+ id: string
20709
+ /**
20710
+ * The comment it replies to, for a reply
20711
+ */
20712
+ parentId?: string
20713
+ anchor: {
20714
+ /**
20715
+ * The id of the canvas's board it is about
20716
+ */
20717
+ board?: string
20718
+ /**
20719
+ * The address of the board's element it is about, such as body>main:0>h1:0
20720
+ */
20721
+ element?: string
20722
+ /**
20723
+ * The element's first words, which name it once it is gone; kept to 120 characters
20724
+ */
20725
+ label?: string
20726
+ /**
20727
+ * Where on the board its pin is, as fractions of the board's width and height from its top left
20728
+ */
20729
+ point?: {
20730
+ x: number
20731
+ y: number
20732
+ }
20733
+ /**
20734
+ * The artifact's revision its author saw
20735
+ */
20736
+ revision: number
20737
+ }
20738
+ /**
20739
+ * Plain text
20740
+ */
20741
+ body: string
20742
+ /**
20743
+ * Who wrote it: a principal, or a guest, someone without an account who opened a shared link, whose id is their link's session
20744
+ */
20745
+ author: {
20746
+ type: "user" | "serviceAccount" | "system" | "guest"
20747
+ id: string
20748
+ }
20749
+ /**
20750
+ * Its author's name: a member's profile name or email, the project's for its own code, or the name a guest gave; null for anyone the project cannot name. A guest reading it never gets a member's email
20751
+ */
20752
+ authorName: string | null
20753
+ /**
20754
+ * The Agent's run that wrote it for its author, and that run's conversation
20755
+ */
20756
+ origin?: {
20757
+ threadId: string
20758
+ runId: string
20759
+ }
20760
+ createdAt: string
20761
+ /**
20762
+ * When someone marked it resolved
20763
+ */
20764
+ resolvedAt?: string
20765
+ /**
20766
+ * Who marked it resolved
20767
+ */
20768
+ resolvedBy?: {
20769
+ type: "user" | "serviceAccount" | "system"
20770
+ id: string
20771
+ }
20772
+ }
20773
+ }
20774
+
20775
+ export type ResolveArtifactCommentResponse =
20776
+ ResolveArtifactCommentResponses[keyof ResolveArtifactCommentResponses]
20777
+
20778
+ export type DeleteArtifactCommentData = {
20779
+ body?: never
20780
+ path: {
20781
+ artifactId: string
20782
+ commentId: string
20783
+ }
20784
+ query?: never
20785
+ url: "/api/artifacts/{artifactId}/comments/{commentId}"
20786
+ }
20787
+
20788
+ export type DeleteArtifactCommentErrors = {
20789
+ /**
20790
+ * Response for status 403
20791
+ */
20792
+ 403: {
20793
+ error: string
20794
+ /**
20795
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20796
+ */
20797
+ code?: string
20798
+ /**
20799
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20800
+ */
20801
+ latest?: {
20802
+ version: number
20803
+ revision: number
20804
+ author: {
20805
+ type: "user" | "serviceAccount" | "system"
20806
+ id: string
20807
+ }
20808
+ frozenBy?: {
20809
+ type: "user" | "serviceAccount" | "system"
20810
+ id: string
20811
+ }
20812
+ }
20813
+ }
20814
+ /**
20815
+ * Response for status 404
20816
+ */
20817
+ 404: {
20818
+ error: string
20819
+ /**
20820
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20821
+ */
20822
+ code?: string
20823
+ /**
20824
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20825
+ */
20826
+ latest?: {
20827
+ version: number
20828
+ revision: number
20829
+ author: {
20830
+ type: "user" | "serviceAccount" | "system"
20831
+ id: string
20832
+ }
20833
+ frozenBy?: {
20834
+ type: "user" | "serviceAccount" | "system"
20835
+ id: string
20836
+ }
20837
+ }
20838
+ }
20839
+ /**
20840
+ * Response for status 501
20841
+ */
20842
+ 501: {
20843
+ error: string
20844
+ /**
20845
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20846
+ */
20847
+ code?: string
20848
+ /**
20849
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20850
+ */
20851
+ latest?: {
20852
+ version: number
20853
+ revision: number
20854
+ author: {
20855
+ type: "user" | "serviceAccount" | "system"
20856
+ id: string
20857
+ }
20858
+ frozenBy?: {
20859
+ type: "user" | "serviceAccount" | "system"
20860
+ id: string
20861
+ }
20862
+ }
20863
+ }
20864
+ }
20865
+
20866
+ export type DeleteArtifactCommentError =
20867
+ DeleteArtifactCommentErrors[keyof DeleteArtifactCommentErrors]
20868
+
20869
+ export type DeleteArtifactCommentResponses = {
20870
+ /**
20871
+ * Response for status 200
20872
+ */
20873
+ 200: {
20874
+ deleted: true
20875
+ }
20876
+ }
20877
+
20878
+ export type DeleteArtifactCommentResponse =
20879
+ DeleteArtifactCommentResponses[keyof DeleteArtifactCommentResponses]
20880
+
20881
+ export type ListArtifactRestorePointsData = {
20882
+ body?: never
20883
+ path: {
20884
+ artifactId: string
20885
+ }
20886
+ query?: never
20887
+ url: "/api/artifacts/{artifactId}/restore-points"
20888
+ }
20889
+
20890
+ export type ListArtifactRestorePointsErrors = {
20891
+ /**
20892
+ * Response for status 403
20893
+ */
20894
+ 403: {
20895
+ error: string
20896
+ /**
20897
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20898
+ */
20899
+ code?: string
20900
+ /**
20901
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20902
+ */
20903
+ latest?: {
20904
+ version: number
20905
+ revision: number
20906
+ author: {
20907
+ type: "user" | "serviceAccount" | "system"
20908
+ id: string
20909
+ }
20910
+ frozenBy?: {
20911
+ type: "user" | "serviceAccount" | "system"
20912
+ id: string
20913
+ }
20914
+ }
20915
+ }
20916
+ /**
20917
+ * Response for status 404
20918
+ */
20919
+ 404: {
20920
+ error: string
20921
+ /**
20922
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20923
+ */
20924
+ code?: string
20925
+ /**
20926
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20927
+ */
20928
+ latest?: {
20929
+ version: number
20930
+ revision: number
20931
+ author: {
20932
+ type: "user" | "serviceAccount" | "system"
20933
+ id: string
20934
+ }
20935
+ frozenBy?: {
20936
+ type: "user" | "serviceAccount" | "system"
20937
+ id: string
20938
+ }
20939
+ }
20940
+ }
20941
+ /**
20942
+ * Response for status 501
20943
+ */
20944
+ 501: {
20945
+ error: string
20946
+ /**
20947
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
20948
+ */
20949
+ code?: string
20950
+ /**
20951
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
20952
+ */
20953
+ latest?: {
20954
+ version: number
20955
+ revision: number
20956
+ author: {
20957
+ type: "user" | "serviceAccount" | "system"
20958
+ id: string
20959
+ }
20960
+ frozenBy?: {
20961
+ type: "user" | "serviceAccount" | "system"
20962
+ id: string
20963
+ }
20964
+ }
20965
+ }
20966
+ }
20967
+
20968
+ export type ListArtifactRestorePointsError =
20969
+ ListArtifactRestorePointsErrors[keyof ListArtifactRestorePointsErrors]
20970
+
20971
+ export type ListArtifactRestorePointsResponses = {
20972
+ /**
20973
+ * Response for status 200
20974
+ */
20975
+ 200: {
20976
+ /**
20977
+ * Newest first: an artifact keeps its last 20
20978
+ */
20979
+ restorePoints: Array<{
20980
+ artifactId: string
20981
+ /**
20982
+ * The revision whose content it holds, which restores it
20983
+ */
20984
+ revision: number
20985
+ /**
20986
+ * The version it was taken of
20987
+ */
20988
+ version: number
20989
+ /**
20990
+ * Whether that version was already created, and so frozen, when the point was taken: its content is then that version's
20991
+ */
20992
+ frozen: boolean
20993
+ title: string
20994
+ /**
20995
+ * Who had last written that content
20996
+ */
20997
+ author: {
20998
+ type: "user" | "serviceAccount" | "system"
20999
+ id: string
21000
+ }
21001
+ origin?: {
21002
+ threadId: string
21003
+ runId: string
21004
+ }
21005
+ /**
21006
+ * When that content was written
21007
+ */
21008
+ updatedAt: string
21009
+ /**
21010
+ * Taken before an Agent turn's first write to the artifact, or before a restore
21011
+ */
21012
+ reason: "turn" | "restore"
21013
+ /**
21014
+ * With turn: the turn's run
21015
+ */
21016
+ turnRunId?: string
21017
+ /**
21018
+ * When it was taken
21019
+ */
21020
+ createdAt: string
21021
+ }>
21022
+ }
21023
+ }
21024
+
21025
+ export type ListArtifactRestorePointsResponse =
21026
+ ListArtifactRestorePointsResponses[keyof ListArtifactRestorePointsResponses]
21027
+
21028
+ export type GetArtifactRestorePointData = {
21029
+ body?: never
21030
+ path: {
21031
+ artifactId: string
21032
+ /**
21033
+ * The revision whose content the restore point holds
21034
+ */
21035
+ revision: string
21036
+ }
21037
+ query?: never
21038
+ url: "/api/artifacts/{artifactId}/restore-points/{revision}"
21039
+ }
21040
+
21041
+ export type GetArtifactRestorePointErrors = {
21042
+ /**
21043
+ * Response for status 403
21044
+ */
21045
+ 403: {
21046
+ error: string
21047
+ /**
21048
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
21049
+ */
21050
+ code?: string
21051
+ /**
21052
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
21053
+ */
21054
+ latest?: {
21055
+ version: number
21056
+ revision: number
21057
+ author: {
21058
+ type: "user" | "serviceAccount" | "system"
21059
+ id: string
21060
+ }
21061
+ frozenBy?: {
21062
+ type: "user" | "serviceAccount" | "system"
21063
+ id: string
21064
+ }
21065
+ }
21066
+ }
21067
+ /**
21068
+ * Response for status 404
21069
+ */
21070
+ 404: {
21071
+ error: string
21072
+ /**
21073
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
21074
+ */
21075
+ code?: string
21076
+ /**
21077
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
21078
+ */
21079
+ latest?: {
21080
+ version: number
21081
+ revision: number
21082
+ author: {
21083
+ type: "user" | "serviceAccount" | "system"
21084
+ id: string
21085
+ }
21086
+ frozenBy?: {
21087
+ type: "user" | "serviceAccount" | "system"
21088
+ id: string
21089
+ }
21090
+ }
21091
+ }
21092
+ /**
21093
+ * Response for status 501
21094
+ */
21095
+ 501: {
21096
+ error: string
21097
+ /**
21098
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
21099
+ */
21100
+ code?: string
21101
+ /**
21102
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
21103
+ */
21104
+ latest?: {
21105
+ version: number
21106
+ revision: number
21107
+ author: {
21108
+ type: "user" | "serviceAccount" | "system"
21109
+ id: string
21110
+ }
21111
+ frozenBy?: {
21112
+ type: "user" | "serviceAccount" | "system"
21113
+ id: string
21114
+ }
21115
+ }
21116
+ }
21117
+ }
21118
+
21119
+ export type GetArtifactRestorePointError =
21120
+ GetArtifactRestorePointErrors[keyof GetArtifactRestorePointErrors]
21121
+
21122
+ export type GetArtifactRestorePointResponses = {
21123
+ /**
21124
+ * Response for status 200
21125
+ */
21126
+ 200: {
21127
+ artifactId: string
21128
+ /**
21129
+ * The revision whose content it holds, which restores it
21130
+ */
21131
+ revision: number
21132
+ /**
21133
+ * The version it was taken of
21134
+ */
21135
+ version: number
21136
+ /**
21137
+ * Whether that version was already created, and so frozen, when the point was taken: its content is then that version's
21138
+ */
21139
+ frozen: boolean
21140
+ title: string
21141
+ /**
21142
+ * Who had last written that content
21143
+ */
21144
+ author: {
21145
+ type: "user" | "serviceAccount" | "system"
21146
+ id: string
21147
+ }
21148
+ origin?: {
21149
+ threadId: string
21150
+ runId: string
21151
+ }
21152
+ /**
21153
+ * When that content was written
21154
+ */
21155
+ updatedAt: string
21156
+ /**
21157
+ * Taken before an Agent turn's first write to the artifact, or before a restore
21158
+ */
21159
+ reason: "turn" | "restore"
21160
+ /**
21161
+ * With turn: the turn's run
21162
+ */
21163
+ turnRunId?: string
21164
+ /**
21165
+ * When it was taken
21166
+ */
21167
+ createdAt: string
21168
+ entry: string
21169
+ files: Array<{
21170
+ /**
21171
+ * The file's path inside the artifact, such as figures/revenue.svg
21172
+ */
21173
+ path: string
21174
+ file: {
21175
+ blobId: string
21176
+ digest: string
21177
+ sizeBytes: number
21178
+ fileName?: string
21179
+ mediaType?: string
21180
+ logicalPath?: string
21181
+ }
21182
+ }>
21183
+ outline:
21184
+ | {
21185
+ kind: "document"
21186
+ headings: Array<{
21187
+ depth: number
21188
+ text: string
21189
+ slug: string
21190
+ }>
21191
+ }
21192
+ | {
21193
+ kind: "sheet"
21194
+ sheets: Array<{
21195
+ name: string
21196
+ /**
21197
+ * The rows of its CSV; none for a live sheet
21198
+ */
21199
+ rows: number
21200
+ columns: Array<string>
21201
+ /**
21202
+ * A live sheet's query, queries/<name>.json, whose rows each reader reads
21203
+ */
21204
+ query?: string
21205
+ }>
21206
+ charts: Array<string>
21207
+ }
21208
+ | {
21209
+ kind: "slides"
21210
+ slides: Array<{
21211
+ title?: string
21212
+ }>
21213
+ }
21214
+ | {
21215
+ kind: "page"
21216
+ title?: string
21217
+ }
21218
+ | {
21219
+ kind: "canvas"
21220
+ items: Array<
21221
+ | {
21222
+ id: string
21223
+ type: "board"
21224
+ title?: string
21225
+ file: string
21226
+ w: number
21227
+ h: number
21228
+ /**
21229
+ * What the board's preview is a picture of: a board kept as it was keeps it
21230
+ */
21231
+ renderKey?: string
21232
+ }
21233
+ | {
21234
+ id: string
21235
+ type: "section"
21236
+ title?: string
21237
+ }
21238
+ >
21239
+ /**
21240
+ * The modes each board has a preview in: both, or the one its theme.json pins
21241
+ */
21242
+ themes?: Array<"light" | "dark">
21243
+ }
21244
+ | {
21245
+ kind: "file"
21246
+ mediaType: string
21247
+ }
21248
+ references: Array<{
21249
+ address: string
21250
+ as: "embed" | "link"
21251
+ at: string
21252
+ resolvedVersion: number
21253
+ }>
21254
+ }
21255
+ }
21256
+
21257
+ export type GetArtifactRestorePointResponse =
21258
+ GetArtifactRestorePointResponses[keyof GetArtifactRestorePointResponses]
21259
+
21260
+ export type GetArtifactRestorePointFileContentData = {
21261
+ body?: never
21262
+ path: {
21263
+ artifactId: string
21264
+ /**
21265
+ * The revision whose content the restore point holds
21266
+ */
21267
+ revision: string
21268
+ }
21269
+ query: {
21270
+ path: string
21271
+ disposition?: "inline" | "attachment"
21272
+ /**
21273
+ * Client cache key; the route still resolves the current file
21274
+ */
21275
+ v?: string
21276
+ }
21277
+ url: "/api/artifacts/{artifactId}/restore-points/{revision}/content"
21278
+ }
21279
+
21280
+ export type GetArtifactRestorePointFileContentErrors = {
21281
+ /**
21282
+ * Response for status 400
21283
+ */
21284
+ 400: ErrorResponse
21285
+ /**
21286
+ * Response for status 404
21287
+ */
21288
+ 404: ErrorResponse
21289
+ /**
21290
+ * Requested byte range is not satisfiable
21291
+ */
21292
+ 416: unknown
21293
+ /**
21294
+ * The storage role backing this content is not configured
21295
+ */
21296
+ 501: ErrorResponse
21297
+ }
21298
+
21299
+ export type GetArtifactRestorePointFileContentError =
21300
+ GetArtifactRestorePointFileContentErrors[keyof GetArtifactRestorePointFileContentErrors]
21301
+
21302
+ export type GetArtifactRestorePointFileContentResponses = {
21303
+ /**
21304
+ * File content
21305
+ */
21306
+ 200: Blob | File
21307
+ /**
21308
+ * Partial file content
21309
+ */
21310
+ 206: Blob | File
21311
+ }
21312
+
21313
+ export type GetArtifactRestorePointFileContentResponse =
21314
+ GetArtifactRestorePointFileContentResponses[keyof GetArtifactRestorePointFileContentResponses]
21315
+
21316
+ export type RestoreArtifactData = {
21317
+ body: {
21318
+ /**
21319
+ * The revision this was made from. When the artifact changed since, it is refused with 409 artifact_moved, naming the revision and who last wrote the latest version.
21320
+ */
21321
+ baseRevision?: number
21322
+ }
21323
+ path: {
21324
+ artifactId: string
21325
+ /**
21326
+ * The revision whose content the restore point holds
21327
+ */
21328
+ revision: string
21329
+ }
21330
+ query?: never
21331
+ url: "/api/artifacts/{artifactId}/restore-points/{revision}/restore"
21332
+ }
21333
+
21334
+ export type RestoreArtifactErrors = {
21335
+ /**
21336
+ * Response for status 400
21337
+ */
21338
+ 400: {
21339
+ error: string
21340
+ /**
21341
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
21342
+ */
21343
+ code?: string
21344
+ /**
21345
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
21346
+ */
21347
+ latest?: {
21348
+ version: number
21349
+ revision: number
21350
+ author: {
21351
+ type: "user" | "serviceAccount" | "system"
21352
+ id: string
21353
+ }
21354
+ frozenBy?: {
21355
+ type: "user" | "serviceAccount" | "system"
21356
+ id: string
21357
+ }
21358
+ }
21359
+ }
21360
+ /**
21361
+ * Response for status 403
21362
+ */
21363
+ 403: {
21364
+ error: string
21365
+ /**
21366
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
21367
+ */
21368
+ code?: string
21369
+ /**
21370
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
21371
+ */
21372
+ latest?: {
21373
+ version: number
21374
+ revision: number
21375
+ author: {
21376
+ type: "user" | "serviceAccount" | "system"
21377
+ id: string
21378
+ }
21379
+ frozenBy?: {
21380
+ type: "user" | "serviceAccount" | "system"
21381
+ id: string
21382
+ }
21383
+ }
21384
+ }
21385
+ /**
21386
+ * Response for status 404
21387
+ */
21388
+ 404: {
21389
+ error: string
21390
+ /**
21391
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
21392
+ */
21393
+ code?: string
21394
+ /**
21395
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
21396
+ */
21397
+ latest?: {
21398
+ version: number
21399
+ revision: number
21400
+ author: {
21401
+ type: "user" | "serviceAccount" | "system"
21402
+ id: string
21403
+ }
21404
+ frozenBy?: {
21405
+ type: "user" | "serviceAccount" | "system"
21406
+ id: string
21407
+ }
21408
+ }
21409
+ }
21410
+ /**
21411
+ * Response for status 409
21412
+ */
21413
+ 409: {
21414
+ error: string
21415
+ /**
21416
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
21417
+ */
21418
+ code?: string
21419
+ /**
21420
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
21421
+ */
21422
+ latest?: {
21423
+ version: number
21424
+ revision: number
21425
+ author: {
21426
+ type: "user" | "serviceAccount" | "system"
21427
+ id: string
21428
+ }
21429
+ frozenBy?: {
21430
+ type: "user" | "serviceAccount" | "system"
21431
+ id: string
21432
+ }
21433
+ }
21434
+ }
21435
+ /**
21436
+ * Response for status 501
21437
+ */
21438
+ 501: {
21439
+ error: string
21440
+ /**
21441
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
21442
+ */
21443
+ code?: string
21444
+ /**
21445
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
21446
+ */
21447
+ latest?: {
21448
+ version: number
21449
+ revision: number
21450
+ author: {
21451
+ type: "user" | "serviceAccount" | "system"
21452
+ id: string
21453
+ }
21454
+ frozenBy?: {
21455
+ type: "user" | "serviceAccount" | "system"
21456
+ id: string
21457
+ }
21458
+ }
21459
+ }
21460
+ }
21461
+
21462
+ export type RestoreArtifactError = RestoreArtifactErrors[keyof RestoreArtifactErrors]
21463
+
21464
+ export type RestoreArtifactResponses = {
21465
+ /**
21466
+ * Response for status 200
21467
+ */
21468
+ 200: {
21469
+ artifact: {
21470
+ id: string
21471
+ projectId: string
21472
+ kind: "document" | "sheet" | "slides" | "page" | "canvas" | "file"
21473
+ title: string
21474
+ owner: {
21475
+ type: "user" | "serviceAccount" | "system"
21476
+ id: string
21477
+ }
21478
+ latestVersion: number
21479
+ /**
21480
+ * Counts the artifact's changes: a write, a version created, a restore. It only grows, so content read at one revision is that revision's for good
21481
+ */
21482
+ revision: number
21483
+ createdAt: string
21484
+ /**
21485
+ * When the artifact last changed
21486
+ */
18910
21487
  updatedAt: string
18911
21488
  }
18912
21489
  version: {
18913
21490
  artifactId: string
18914
21491
  version: number
21492
+ /**
21493
+ * The artifact's revision when this version last changed: the latest version's is the artifact's
21494
+ */
21495
+ revision: number
21496
+ /**
21497
+ * Someone created this version: it never changes again. The latest version is open until then, and each write replaces its content
21498
+ */
21499
+ frozen: boolean
18915
21500
  title: string
18916
21501
  entry: string
18917
21502
  files: Array<{
@@ -18973,6 +21558,10 @@ export type PublishArtifactVersionResponses = {
18973
21558
  file: string
18974
21559
  w: number
18975
21560
  h: number
21561
+ /**
21562
+ * What the board's preview is a picture of: a board kept as it was keeps it
21563
+ */
21564
+ renderKey?: string
18976
21565
  }
18977
21566
  | {
18978
21567
  id: string
@@ -18980,6 +21569,10 @@ export type PublishArtifactVersionResponses = {
18980
21569
  title?: string
18981
21570
  }
18982
21571
  >
21572
+ /**
21573
+ * The modes each board has a preview in: both, or the one its theme.json pins
21574
+ */
21575
+ themes?: Array<"light" | "dark">
18983
21576
  }
18984
21577
  | {
18985
21578
  kind: "file"
@@ -18991,26 +21584,50 @@ export type PublishArtifactVersionResponses = {
18991
21584
  at: string
18992
21585
  resolvedVersion: number
18993
21586
  }>
21587
+ /**
21588
+ * Who last wrote its content
21589
+ */
18994
21590
  author: {
18995
21591
  type: "user" | "serviceAccount" | "system"
18996
21592
  id: string
18997
21593
  }
21594
+ /**
21595
+ * The Agent turn and thread its content was last written from
21596
+ */
18998
21597
  origin?: {
18999
21598
  threadId: string
19000
21599
  runId: string
19001
21600
  }
21601
+ /**
21602
+ * When the version was opened
21603
+ */
19002
21604
  createdAt: string
21605
+ /**
21606
+ * When its content was last written
21607
+ */
21608
+ updatedAt: string
21609
+ /**
21610
+ * When it was created, which froze it
21611
+ */
21612
+ frozenAt?: string
21613
+ /**
21614
+ * Who created it
21615
+ */
21616
+ frozenBy?: {
21617
+ type: "user" | "serviceAccount" | "system"
21618
+ id: string
21619
+ }
21620
+ /**
21621
+ * A canvas's boards by id, as reading or publishing the version returns them: ready when its preview is, pending while it is rendered, none when none will come and the board shows its outline
21622
+ */
21623
+ boardPreviews?: {
21624
+ [key: string]: "ready" | "pending" | "none"
21625
+ }
19003
21626
  }
19004
- warnings: Array<{
19005
- code: string
19006
- message: string
19007
- part?: string
19008
- }>
19009
21627
  }
19010
21628
  }
19011
21629
 
19012
- export type PublishArtifactVersionResponse =
19013
- PublishArtifactVersionResponses[keyof PublishArtifactVersionResponses]
21630
+ export type RestoreArtifactResponse = RestoreArtifactResponses[keyof RestoreArtifactResponses]
19014
21631
 
19015
21632
  export type CreateArtifactFrameData = {
19016
21633
  body?: never
@@ -19032,18 +21649,23 @@ export type CreateArtifactFrameErrors = {
19032
21649
  403: {
19033
21650
  error: string
19034
21651
  /**
19035
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
21652
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19036
21653
  */
19037
21654
  code?: string
19038
21655
  /**
19039
- * With artifact_moved: the latest version and who published it
21656
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
19040
21657
  */
19041
21658
  latest?: {
19042
21659
  version: number
21660
+ revision: number
19043
21661
  author: {
19044
21662
  type: "user" | "serviceAccount" | "system"
19045
21663
  id: string
19046
21664
  }
21665
+ frozenBy?: {
21666
+ type: "user" | "serviceAccount" | "system"
21667
+ id: string
21668
+ }
19047
21669
  }
19048
21670
  }
19049
21671
  /**
@@ -19052,18 +21674,23 @@ export type CreateArtifactFrameErrors = {
19052
21674
  404: {
19053
21675
  error: string
19054
21676
  /**
19055
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
21677
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19056
21678
  */
19057
21679
  code?: string
19058
21680
  /**
19059
- * With artifact_moved: the latest version and who published it
21681
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
19060
21682
  */
19061
21683
  latest?: {
19062
21684
  version: number
21685
+ revision: number
19063
21686
  author: {
19064
21687
  type: "user" | "serviceAccount" | "system"
19065
21688
  id: string
19066
21689
  }
21690
+ frozenBy?: {
21691
+ type: "user" | "serviceAccount" | "system"
21692
+ id: string
21693
+ }
19067
21694
  }
19068
21695
  }
19069
21696
  /**
@@ -19072,18 +21699,23 @@ export type CreateArtifactFrameErrors = {
19072
21699
  409: {
19073
21700
  error: string
19074
21701
  /**
19075
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
21702
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19076
21703
  */
19077
21704
  code?: string
19078
21705
  /**
19079
- * With artifact_moved: the latest version and who published it
21706
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
19080
21707
  */
19081
21708
  latest?: {
19082
21709
  version: number
21710
+ revision: number
19083
21711
  author: {
19084
21712
  type: "user" | "serviceAccount" | "system"
19085
21713
  id: string
19086
21714
  }
21715
+ frozenBy?: {
21716
+ type: "user" | "serviceAccount" | "system"
21717
+ id: string
21718
+ }
19087
21719
  }
19088
21720
  }
19089
21721
  /**
@@ -19092,18 +21724,23 @@ export type CreateArtifactFrameErrors = {
19092
21724
  501: {
19093
21725
  error: string
19094
21726
  /**
19095
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
21727
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19096
21728
  */
19097
21729
  code?: string
19098
21730
  /**
19099
- * With artifact_moved: the latest version and who published it
21731
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
19100
21732
  */
19101
21733
  latest?: {
19102
21734
  version: number
21735
+ revision: number
19103
21736
  author: {
19104
21737
  type: "user" | "serviceAccount" | "system"
19105
21738
  id: string
19106
21739
  }
21740
+ frozenBy?: {
21741
+ type: "user" | "serviceAccount" | "system"
21742
+ id: string
21743
+ }
19107
21744
  }
19108
21745
  }
19109
21746
  }
@@ -19149,18 +21786,23 @@ export type GetArtifactVersionErrors = {
19149
21786
  403: {
19150
21787
  error: string
19151
21788
  /**
19152
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
21789
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19153
21790
  */
19154
21791
  code?: string
19155
21792
  /**
19156
- * With artifact_moved: the latest version and who published it
21793
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
19157
21794
  */
19158
21795
  latest?: {
19159
21796
  version: number
21797
+ revision: number
19160
21798
  author: {
19161
21799
  type: "user" | "serviceAccount" | "system"
19162
21800
  id: string
19163
21801
  }
21802
+ frozenBy?: {
21803
+ type: "user" | "serviceAccount" | "system"
21804
+ id: string
21805
+ }
19164
21806
  }
19165
21807
  }
19166
21808
  /**
@@ -19169,18 +21811,23 @@ export type GetArtifactVersionErrors = {
19169
21811
  404: {
19170
21812
  error: string
19171
21813
  /**
19172
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
21814
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19173
21815
  */
19174
21816
  code?: string
19175
21817
  /**
19176
- * With artifact_moved: the latest version and who published it
21818
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
19177
21819
  */
19178
21820
  latest?: {
19179
21821
  version: number
21822
+ revision: number
19180
21823
  author: {
19181
21824
  type: "user" | "serviceAccount" | "system"
19182
21825
  id: string
19183
21826
  }
21827
+ frozenBy?: {
21828
+ type: "user" | "serviceAccount" | "system"
21829
+ id: string
21830
+ }
19184
21831
  }
19185
21832
  }
19186
21833
  /**
@@ -19189,18 +21836,23 @@ export type GetArtifactVersionErrors = {
19189
21836
  501: {
19190
21837
  error: string
19191
21838
  /**
19192
- * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, invalid_artifact, invalid_state, state_full, not_allowed, not_shared (it exists but no conversation you read shares it), read_only (you observe the conversation that shares it), query_not_found, query_invalid (the ontology no longer admits the query), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
21839
+ * Stable machine-readable failure code: artifact_not_found, artifact_kind_mismatch, artifact_moved, restore_point_not_found, comment_not_found, invalid_artifact, invalid_comment, invalid_state, name_required (a shared link's guest gives their name before commenting), state_full, comments_full, not_allowed, not_shared (it exists but neither a conversation nor an object you read shares it), read_only (you only read it), query_not_found, query_invalid (the ontology no longer admits the query), preview_not_found (the board has no preview yet, or will have none), execution_lost (a run token's run ended or moved to another runner), or storage_unavailable.
19193
21840
  */
19194
21841
  code?: string
19195
21842
  /**
19196
- * With artifact_moved: the latest version and who published it
21843
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
19197
21844
  */
19198
21845
  latest?: {
19199
21846
  version: number
21847
+ revision: number
19200
21848
  author: {
19201
21849
  type: "user" | "serviceAccount" | "system"
19202
21850
  id: string
19203
21851
  }
21852
+ frozenBy?: {
21853
+ type: "user" | "serviceAccount" | "system"
21854
+ id: string
21855
+ }
19204
21856
  }
19205
21857
  }
19206
21858
  }
@@ -19214,6 +21866,14 @@ export type GetArtifactVersionResponses = {
19214
21866
  200: {
19215
21867
  artifactId: string
19216
21868
  version: number
21869
+ /**
21870
+ * The artifact's revision when this version last changed: the latest version's is the artifact's
21871
+ */
21872
+ revision: number
21873
+ /**
21874
+ * Someone created this version: it never changes again. The latest version is open until then, and each write replaces its content
21875
+ */
21876
+ frozen: boolean
19217
21877
  title: string
19218
21878
  entry: string
19219
21879
  files: Array<{
@@ -19275,6 +21935,10 @@ export type GetArtifactVersionResponses = {
19275
21935
  file: string
19276
21936
  w: number
19277
21937
  h: number
21938
+ /**
21939
+ * What the board's preview is a picture of: a board kept as it was keeps it
21940
+ */
21941
+ renderKey?: string
19278
21942
  }
19279
21943
  | {
19280
21944
  id: string
@@ -19282,6 +21946,10 @@ export type GetArtifactVersionResponses = {
19282
21946
  title?: string
19283
21947
  }
19284
21948
  >
21949
+ /**
21950
+ * The modes each board has a preview in: both, or the one its theme.json pins
21951
+ */
21952
+ themes?: Array<"light" | "dark">
19285
21953
  }
19286
21954
  | {
19287
21955
  kind: "file"
@@ -19293,21 +21961,121 @@ export type GetArtifactVersionResponses = {
19293
21961
  at: string
19294
21962
  resolvedVersion: number
19295
21963
  }>
21964
+ /**
21965
+ * Who last wrote its content
21966
+ */
19296
21967
  author: {
19297
21968
  type: "user" | "serviceAccount" | "system"
19298
21969
  id: string
19299
21970
  }
21971
+ /**
21972
+ * The Agent turn and thread its content was last written from
21973
+ */
19300
21974
  origin?: {
19301
21975
  threadId: string
19302
21976
  runId: string
19303
21977
  }
21978
+ /**
21979
+ * When the version was opened
21980
+ */
19304
21981
  createdAt: string
21982
+ /**
21983
+ * When its content was last written
21984
+ */
21985
+ updatedAt: string
21986
+ /**
21987
+ * When it was created, which froze it
21988
+ */
21989
+ frozenAt?: string
21990
+ /**
21991
+ * Who created it
21992
+ */
21993
+ frozenBy?: {
21994
+ type: "user" | "serviceAccount" | "system"
21995
+ id: string
21996
+ }
21997
+ /**
21998
+ * A canvas's boards by id, as reading or publishing the version returns them: ready when its preview is, pending while it is rendered, none when none will come and the board shows its outline
21999
+ */
22000
+ boardPreviews?: {
22001
+ [key: string]: "ready" | "pending" | "none"
22002
+ }
19305
22003
  }
19306
22004
  }
19307
22005
 
19308
22006
  export type GetArtifactVersionResponse =
19309
22007
  GetArtifactVersionResponses[keyof GetArtifactVersionResponses]
19310
22008
 
22009
+ export type GetArtifactBoardPreviewData = {
22010
+ body?: never
22011
+ path: {
22012
+ artifactId: string
22013
+ /**
22014
+ * A version number, or "latest"
22015
+ */
22016
+ version: string
22017
+ /**
22018
+ * The board's id in the canvas
22019
+ */
22020
+ board: string
22021
+ }
22022
+ query?: {
22023
+ /**
22024
+ * The reader's mode; a canvas whose theme.json pins one is pictured only in it
22025
+ */
22026
+ theme?: "light" | "dark"
22027
+ /**
22028
+ * full, the default: a PNG of the board at its own size. small: a WebP at most 480 pixels wide, for a canvas that shows many boards at once
22029
+ */
22030
+ size?: "full" | "small"
22031
+ /**
22032
+ * The version's revision the picture is of. Another than the version's current one is 404 preview_not_found: the version changed, and says which pictures it has now. One that matches is cached for good
22033
+ */
22034
+ revision?: number
22035
+ /**
22036
+ * The board's render key the picture is of, as the version's outline names it, in place of revision: the picture stays the same while the board shows the same, however often the canvas around it changes. Another than the board's current one is 404 preview_not_found. One that matches is cached for good
22037
+ */
22038
+ key?: string
22039
+ /**
22040
+ * Share grant selector for elements that cannot send the x-sixb-share-grant header
22041
+ */
22042
+ shareGrant?: string
22043
+ }
22044
+ url: "/api/artifacts/{artifactId}/versions/{version}/boards/{board}/preview"
22045
+ }
22046
+
22047
+ export type GetArtifactBoardPreviewErrors = {
22048
+ /**
22049
+ * Response for status 400
22050
+ */
22051
+ 400: ArtifactErrorResponse
22052
+ /**
22053
+ * Response for status 403
22054
+ */
22055
+ 403: ArtifactErrorResponse
22056
+ /**
22057
+ * Response for status 404
22058
+ */
22059
+ 404: ArtifactErrorResponse
22060
+ /**
22061
+ * Response for status 501
22062
+ */
22063
+ 501: ArtifactErrorResponse
22064
+ }
22065
+
22066
+ export type GetArtifactBoardPreviewError =
22067
+ GetArtifactBoardPreviewErrors[keyof GetArtifactBoardPreviewErrors]
22068
+
22069
+ export type GetArtifactBoardPreviewResponses = {
22070
+ /**
22071
+ * The board's preview
22072
+ */
22073
+ 200: Blob | File
22074
+ }
22075
+
22076
+ export type GetArtifactBoardPreviewResponse =
22077
+ GetArtifactBoardPreviewResponses[keyof GetArtifactBoardPreviewResponses]
22078
+
19311
22079
  export type GetArtifactQueryData = {
19312
22080
  body?: never
19313
22081
  path: {
@@ -19375,6 +22143,10 @@ export type GetArtifactFileContentData = {
19375
22143
  * Client cache key; the route still resolves the current file
19376
22144
  */
19377
22145
  v?: string
22146
+ /**
22147
+ * Share grant selector for elements that cannot send the x-sixb-share-grant header
22148
+ */
22149
+ shareGrant?: string
19378
22150
  }
19379
22151
  url: "/api/artifacts/{artifactId}/versions/{version}/content"
19380
22152
  }
@@ -19431,6 +22203,10 @@ export type HeadArtifactFileContentData = {
19431
22203
  * Client cache key; the route still resolves the current file
19432
22204
  */
19433
22205
  v?: string
22206
+ /**
22207
+ * Share grant selector for elements that cannot send the x-sixb-share-grant header
22208
+ */
22209
+ shareGrant?: string
19434
22210
  }
19435
22211
  url: "/api/artifacts/{artifactId}/versions/{version}/content"
19436
22212
  }
@@ -20422,6 +23198,7 @@ export type ListEventsData = {
20422
23198
  | "datasets"
20423
23199
  | "rules"
20424
23200
  | "users"
23201
+ | "artifacts"
20425
23202
  type?:
20426
23203
  | "object.created"
20427
23204
  | "object.updated"
@@ -20456,6 +23233,8 @@ export type ListEventsData = {
20456
23233
  | "user.reactivated"
20457
23234
  | "user.invited"
20458
23235
  | "user.profile.updated"
23236
+ | "artifact.updated"
23237
+ | "artifact.commented"
20459
23238
  afterCursor?: string
20460
23239
  limit?: string
20461
23240
  }
@@ -21646,6 +24425,8 @@ export type ListEventsResponses = {
21646
24425
  | "user.reactivated"
21647
24426
  | "user.invited"
21648
24427
  | "user.profile.updated"
24428
+ | "artifact.updated"
24429
+ | "artifact.commented"
21649
24430
  topic:
21650
24431
  | "objects"
21651
24432
  | "telemetry"
@@ -21657,6 +24438,7 @@ export type ListEventsResponses = {
21657
24438
  | "datasets"
21658
24439
  | "rules"
21659
24440
  | "users"
24441
+ | "artifacts"
21660
24442
  payload: {
21661
24443
  [key: string]: unknown
21662
24444
  }
@@ -22391,7 +25173,7 @@ export type ListProjectionsResponses = {
22391
25173
  [key: string]: string
22392
25174
  }
22393
25175
  users?: {
22394
- [key: string]: "email"
25176
+ [key: string]: "email" | "id"
22395
25177
  }
22396
25178
  links: {
22397
25179
  [key: string]: {
@@ -22995,7 +25777,7 @@ export type GetProjectionResponses = {
22995
25777
  [key: string]: string
22996
25778
  }
22997
25779
  users?: {
22998
- [key: string]: "email"
25780
+ [key: string]: "email" | "id"
22999
25781
  }
23000
25782
  links: {
23001
25783
  [key: string]: {