@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
@@ -88,18 +88,23 @@ export type ObjectQueryFacetsResponse = {
88
88
  export type ArtifactErrorResponse = {
89
89
  error: string;
90
90
  /**
91
- * 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.
91
+ * 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.
92
92
  */
93
93
  code?: string;
94
94
  /**
95
- * With artifact_moved: the latest version and who published it
95
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
96
96
  */
97
97
  latest?: {
98
98
  version: number;
99
+ revision: number;
99
100
  author: {
100
101
  type: "user" | "serviceAccount" | "system";
101
102
  id: string;
102
103
  };
104
+ frozenBy?: {
105
+ type: "user" | "serviceAccount" | "system";
106
+ id: string;
107
+ };
103
108
  };
104
109
  };
105
110
  export type ArtifactQueryResponse = {
@@ -167,7 +172,7 @@ export type ArtifactQueryProperty = {
167
172
  /**
168
173
  * The property's type, a value type resolved to the schema it names
169
174
  */
170
- type: "string" | "integer" | "double" | "decimal" | "boolean" | "date" | "timestamp" | "uuid" | "fileRef" | "userRef" | "enum" | "array" | "object" | "map";
175
+ type: "string" | "integer" | "double" | "decimal" | "boolean" | "date" | "timestamp" | "uuid" | "fileRef" | "userRef" | "artifactRef" | "enum" | "array" | "object" | "map";
171
176
  /**
172
177
  * What an enum's values are
173
178
  */
@@ -4126,27 +4131,23 @@ export type GetStatusResponses = {
4126
4131
  * Response for status 200
4127
4132
  */
4128
4133
  200: {
4129
- status: "ok" | "degraded";
4134
+ status: "ok" | "degraded" | "unknown";
4130
4135
  objectTypes: number;
4131
4136
  maintenance: {
4132
- running: boolean;
4133
- intervalMs: number;
4134
- lastStartedAt: string | null;
4135
- lastCompletedAt: string | null;
4136
- lastDurationMs: number | null;
4137
- consecutiveFailures: number;
4138
- lastError: string | null;
4137
+ owner: "orchestrator" | "embedded";
4138
+ beatAt: string | null;
4139
+ stale: boolean;
4140
+ passes: Array<{
4141
+ id: string;
4142
+ lastSucceededAt: string | null;
4143
+ consecutiveFailures: number;
4144
+ }>;
4139
4145
  outbox: {
4140
4146
  pendingCount: number;
4141
4147
  oldestPendingAt: string | null;
4142
4148
  retryingCount: number;
4143
4149
  maxAttempts: number;
4144
- } | null;
4145
- cleanup: {
4146
- publishedOutboxRowsDeleted: number;
4147
- terminalSourceRowsDeleted: number;
4148
- terminalSourceMaterializationsDeleted: number;
4149
- } | null;
4150
+ };
4150
4151
  };
4151
4152
  };
4152
4153
  };
@@ -4223,7 +4224,9 @@ export type ListConnectorConnectionsData = {
4223
4224
  path: {
4224
4225
  connectorId: string;
4225
4226
  };
4226
- query?: never;
4227
+ query?: {
4228
+ owner?: "project" | "me";
4229
+ };
4227
4230
  url: "/api/connectors/{connectorId}/connections";
4228
4231
  };
4229
4232
  export type ListConnectorConnectionsErrors = {
@@ -4274,6 +4277,9 @@ export type ListConnectorConnectionsResponses = {
4274
4277
  connectorId: string;
4275
4278
  owner: {
4276
4279
  type: "project";
4280
+ } | {
4281
+ type: "user";
4282
+ id: string;
4277
4283
  };
4278
4284
  slot: string;
4279
4285
  account: {
@@ -4441,6 +4447,9 @@ export type RevokeConnectorConnectionResponses = {
4441
4447
  connectorId: string;
4442
4448
  owner: {
4443
4449
  type: "project";
4450
+ } | {
4451
+ type: "user";
4452
+ id: string;
4444
4453
  };
4445
4454
  slot: string;
4446
4455
  account: {
@@ -4511,6 +4520,9 @@ export type ListPendingConnectorConnectionRunsResponses = {
4511
4520
  kind: "connect" | "reauthorize";
4512
4521
  owner: {
4513
4522
  type: "project";
4523
+ } | {
4524
+ type: "user";
4525
+ id: string;
4514
4526
  };
4515
4527
  slot: string;
4516
4528
  createdAt: string;
@@ -4524,6 +4536,9 @@ export type ListPendingConnectorConnectionRunsResponses = {
4524
4536
  kind: "connect" | "reauthorize";
4525
4537
  owner: {
4526
4538
  type: "project";
4539
+ } | {
4540
+ type: "user";
4541
+ id: string;
4527
4542
  };
4528
4543
  slot: string;
4529
4544
  createdAt: string;
@@ -4535,6 +4550,9 @@ export type ListPendingConnectorConnectionRunsResponses = {
4535
4550
  kind: "connect" | "reauthorize";
4536
4551
  owner: {
4537
4552
  type: "project";
4553
+ } | {
4554
+ type: "user";
4555
+ id: string;
4538
4556
  };
4539
4557
  slot: string;
4540
4558
  createdAt: string;
@@ -4553,6 +4571,9 @@ export type ListPendingConnectorConnectionRunsResponses = {
4553
4571
  kind: "connect" | "reauthorize";
4554
4572
  owner: {
4555
4573
  type: "project";
4574
+ } | {
4575
+ type: "user";
4576
+ id: string;
4556
4577
  };
4557
4578
  slot: string;
4558
4579
  createdAt: string;
@@ -4563,6 +4584,9 @@ export type ListPendingConnectorConnectionRunsResponses = {
4563
4584
  connectorId: string;
4564
4585
  owner: {
4565
4586
  type: "project";
4587
+ } | {
4588
+ type: "user";
4589
+ id: string;
4566
4590
  };
4567
4591
  slot: string;
4568
4592
  account: {
@@ -4580,6 +4604,9 @@ export type ListPendingConnectorConnectionRunsResponses = {
4580
4604
  kind: "connect" | "reauthorize";
4581
4605
  owner: {
4582
4606
  type: "project";
4607
+ } | {
4608
+ type: "user";
4609
+ id: string;
4583
4610
  };
4584
4611
  slot: string;
4585
4612
  createdAt: string;
@@ -4607,6 +4634,9 @@ export type ListPendingConnectorConnectionRunsResponses = {
4607
4634
  kind: "connect" | "reauthorize";
4608
4635
  owner: {
4609
4636
  type: "project";
4637
+ } | {
4638
+ type: "user";
4639
+ id: string;
4610
4640
  };
4611
4641
  slot: string;
4612
4642
  createdAt: string;
@@ -4618,6 +4648,7 @@ export type ListPendingConnectorConnectionRunsResponses = {
4618
4648
  export type ListPendingConnectorConnectionRunsResponse = ListPendingConnectorConnectionRunsResponses[keyof ListPendingConnectorConnectionRunsResponses];
4619
4649
  export type StartConnectorConnectionRunData = {
4620
4650
  body: {
4651
+ owner?: "project" | "me";
4621
4652
  slot: string;
4622
4653
  returnTo: string;
4623
4654
  };
@@ -4708,6 +4739,9 @@ export type StartConnectorConnectionRunResponses = {
4708
4739
  connectorId: string;
4709
4740
  owner: {
4710
4741
  type: "project";
4742
+ } | {
4743
+ type: "user";
4744
+ id: string;
4711
4745
  };
4712
4746
  slot: string;
4713
4747
  account: {
@@ -4779,6 +4813,9 @@ export type GetConnectorConnectionRunResponses = {
4779
4813
  kind: "connect" | "reauthorize";
4780
4814
  owner: {
4781
4815
  type: "project";
4816
+ } | {
4817
+ type: "user";
4818
+ id: string;
4782
4819
  };
4783
4820
  slot: string;
4784
4821
  createdAt: string;
@@ -4792,6 +4829,9 @@ export type GetConnectorConnectionRunResponses = {
4792
4829
  kind: "connect" | "reauthorize";
4793
4830
  owner: {
4794
4831
  type: "project";
4832
+ } | {
4833
+ type: "user";
4834
+ id: string;
4795
4835
  };
4796
4836
  slot: string;
4797
4837
  createdAt: string;
@@ -4803,6 +4843,9 @@ export type GetConnectorConnectionRunResponses = {
4803
4843
  kind: "connect" | "reauthorize";
4804
4844
  owner: {
4805
4845
  type: "project";
4846
+ } | {
4847
+ type: "user";
4848
+ id: string;
4806
4849
  };
4807
4850
  slot: string;
4808
4851
  createdAt: string;
@@ -4821,6 +4864,9 @@ export type GetConnectorConnectionRunResponses = {
4821
4864
  kind: "connect" | "reauthorize";
4822
4865
  owner: {
4823
4866
  type: "project";
4867
+ } | {
4868
+ type: "user";
4869
+ id: string;
4824
4870
  };
4825
4871
  slot: string;
4826
4872
  createdAt: string;
@@ -4831,6 +4877,9 @@ export type GetConnectorConnectionRunResponses = {
4831
4877
  connectorId: string;
4832
4878
  owner: {
4833
4879
  type: "project";
4880
+ } | {
4881
+ type: "user";
4882
+ id: string;
4834
4883
  };
4835
4884
  slot: string;
4836
4885
  account: {
@@ -4848,6 +4897,9 @@ export type GetConnectorConnectionRunResponses = {
4848
4897
  kind: "connect" | "reauthorize";
4849
4898
  owner: {
4850
4899
  type: "project";
4900
+ } | {
4901
+ type: "user";
4902
+ id: string;
4851
4903
  };
4852
4904
  slot: string;
4853
4905
  createdAt: string;
@@ -4875,6 +4927,9 @@ export type GetConnectorConnectionRunResponses = {
4875
4927
  kind: "connect" | "reauthorize";
4876
4928
  owner: {
4877
4929
  type: "project";
4930
+ } | {
4931
+ type: "user";
4932
+ id: string;
4878
4933
  };
4879
4934
  slot: string;
4880
4935
  createdAt: string;
@@ -4886,6 +4941,7 @@ export type GetConnectorConnectionRunResponses = {
4886
4941
  export type GetConnectorConnectionRunResponse = GetConnectorConnectionRunResponses[keyof GetConnectorConnectionRunResponses];
4887
4942
  export type AddConnectorConnectionData = {
4888
4943
  body: {
4944
+ owner?: "project" | "me";
4889
4945
  slot: string;
4890
4946
  };
4891
4947
  path: {
@@ -4954,6 +5010,9 @@ export type AddConnectorConnectionResponses = {
4954
5010
  kind: "connect" | "reauthorize";
4955
5011
  owner: {
4956
5012
  type: "project";
5013
+ } | {
5014
+ type: "user";
5015
+ id: string;
4957
5016
  };
4958
5017
  slot: string;
4959
5018
  createdAt: string;
@@ -4967,6 +5026,9 @@ export type AddConnectorConnectionResponses = {
4967
5026
  kind: "connect" | "reauthorize";
4968
5027
  owner: {
4969
5028
  type: "project";
5029
+ } | {
5030
+ type: "user";
5031
+ id: string;
4970
5032
  };
4971
5033
  slot: string;
4972
5034
  createdAt: string;
@@ -4978,6 +5040,9 @@ export type AddConnectorConnectionResponses = {
4978
5040
  kind: "connect" | "reauthorize";
4979
5041
  owner: {
4980
5042
  type: "project";
5043
+ } | {
5044
+ type: "user";
5045
+ id: string;
4981
5046
  };
4982
5047
  slot: string;
4983
5048
  createdAt: string;
@@ -4996,6 +5061,9 @@ export type AddConnectorConnectionResponses = {
4996
5061
  kind: "connect" | "reauthorize";
4997
5062
  owner: {
4998
5063
  type: "project";
5064
+ } | {
5065
+ type: "user";
5066
+ id: string;
4999
5067
  };
5000
5068
  slot: string;
5001
5069
  createdAt: string;
@@ -5006,6 +5074,9 @@ export type AddConnectorConnectionResponses = {
5006
5074
  connectorId: string;
5007
5075
  owner: {
5008
5076
  type: "project";
5077
+ } | {
5078
+ type: "user";
5079
+ id: string;
5009
5080
  };
5010
5081
  slot: string;
5011
5082
  account: {
@@ -5023,6 +5094,9 @@ export type AddConnectorConnectionResponses = {
5023
5094
  kind: "connect" | "reauthorize";
5024
5095
  owner: {
5025
5096
  type: "project";
5097
+ } | {
5098
+ type: "user";
5099
+ id: string;
5026
5100
  };
5027
5101
  slot: string;
5028
5102
  createdAt: string;
@@ -5050,6 +5124,9 @@ export type AddConnectorConnectionResponses = {
5050
5124
  kind: "connect" | "reauthorize";
5051
5125
  owner: {
5052
5126
  type: "project";
5127
+ } | {
5128
+ type: "user";
5129
+ id: string;
5053
5130
  };
5054
5131
  slot: string;
5055
5132
  createdAt: string;
@@ -5130,6 +5207,9 @@ export type SelectConnectorConnectionRunAccountResponses = {
5130
5207
  kind: "connect" | "reauthorize";
5131
5208
  owner: {
5132
5209
  type: "project";
5210
+ } | {
5211
+ type: "user";
5212
+ id: string;
5133
5213
  };
5134
5214
  slot: string;
5135
5215
  createdAt: string;
@@ -5143,6 +5223,9 @@ export type SelectConnectorConnectionRunAccountResponses = {
5143
5223
  kind: "connect" | "reauthorize";
5144
5224
  owner: {
5145
5225
  type: "project";
5226
+ } | {
5227
+ type: "user";
5228
+ id: string;
5146
5229
  };
5147
5230
  slot: string;
5148
5231
  createdAt: string;
@@ -5154,6 +5237,9 @@ export type SelectConnectorConnectionRunAccountResponses = {
5154
5237
  kind: "connect" | "reauthorize";
5155
5238
  owner: {
5156
5239
  type: "project";
5240
+ } | {
5241
+ type: "user";
5242
+ id: string;
5157
5243
  };
5158
5244
  slot: string;
5159
5245
  createdAt: string;
@@ -5172,6 +5258,9 @@ export type SelectConnectorConnectionRunAccountResponses = {
5172
5258
  kind: "connect" | "reauthorize";
5173
5259
  owner: {
5174
5260
  type: "project";
5261
+ } | {
5262
+ type: "user";
5263
+ id: string;
5175
5264
  };
5176
5265
  slot: string;
5177
5266
  createdAt: string;
@@ -5182,6 +5271,9 @@ export type SelectConnectorConnectionRunAccountResponses = {
5182
5271
  connectorId: string;
5183
5272
  owner: {
5184
5273
  type: "project";
5274
+ } | {
5275
+ type: "user";
5276
+ id: string;
5185
5277
  };
5186
5278
  slot: string;
5187
5279
  account: {
@@ -5199,6 +5291,9 @@ export type SelectConnectorConnectionRunAccountResponses = {
5199
5291
  kind: "connect" | "reauthorize";
5200
5292
  owner: {
5201
5293
  type: "project";
5294
+ } | {
5295
+ type: "user";
5296
+ id: string;
5202
5297
  };
5203
5298
  slot: string;
5204
5299
  createdAt: string;
@@ -5226,6 +5321,9 @@ export type SelectConnectorConnectionRunAccountResponses = {
5226
5321
  kind: "connect" | "reauthorize";
5227
5322
  owner: {
5228
5323
  type: "project";
5324
+ } | {
5325
+ type: "user";
5326
+ id: string;
5229
5327
  };
5230
5328
  slot: string;
5231
5329
  createdAt: string;
@@ -5327,6 +5425,9 @@ export type ReauthorizeConnectorConnectionResponses = {
5327
5425
  connectorId: string;
5328
5426
  owner: {
5329
5427
  type: "project";
5428
+ } | {
5429
+ type: "user";
5430
+ id: string;
5330
5431
  };
5331
5432
  slot: string;
5332
5433
  account: {
@@ -5727,6 +5828,99 @@ export type ListDatasetRowsResponses = {
5727
5828
  };
5728
5829
  };
5729
5830
  export type ListDatasetRowsResponse = ListDatasetRowsResponses[keyof ListDatasetRowsResponses];
5831
+ export type GetLakeHealthData = {
5832
+ body?: never;
5833
+ path?: never;
5834
+ query?: never;
5835
+ url: "/api/lake/health";
5836
+ };
5837
+ export type GetLakeHealthErrors = {
5838
+ /**
5839
+ * Response for status 400
5840
+ */
5841
+ 400: {
5842
+ error: string;
5843
+ };
5844
+ };
5845
+ export type GetLakeHealthError = GetLakeHealthErrors[keyof GetLakeHealthErrors];
5846
+ export type GetLakeHealthResponses = {
5847
+ /**
5848
+ * Response for status 200
5849
+ */
5850
+ 200: {
5851
+ /**
5852
+ * Whether the lake storage provider supports maintenance
5853
+ */
5854
+ available: boolean;
5855
+ cleanup: {
5856
+ /**
5857
+ * What actually happens: `not-requested` when no orchestrator asks, `no-worker` when no lake worker runs what it asks
5858
+ */
5859
+ state: "off" | "idle" | "not-requested" | "no-worker" | "failing" | "cleaning" | "ok";
5860
+ /**
5861
+ * When the orchestrator last asked for cleanup
5862
+ */
5863
+ lastRequestedAt: string | null;
5864
+ /**
5865
+ * When a lake worker last started a cleanup
5866
+ */
5867
+ lastRunAt: string | null;
5868
+ keepVersionsFor: string;
5869
+ deleteFilesAfter: string;
5870
+ cleanupEvery: string;
5871
+ };
5872
+ datasets: Array<{
5873
+ datasetId: string;
5874
+ /**
5875
+ * Whether the dataset has a table in the lake
5876
+ */
5877
+ materialized: boolean;
5878
+ rowCount: number;
5879
+ /**
5880
+ * Data files its current rows are read from
5881
+ */
5882
+ dataFiles: number;
5883
+ /**
5884
+ * Data files small enough that compaction merges them
5885
+ */
5886
+ smallDataFiles: number;
5887
+ dataBytes: number;
5888
+ /**
5889
+ * Files listing deleted rows, until compaction
5890
+ */
5891
+ deleteFiles: number;
5892
+ /**
5893
+ * Rows kept in the catalog rather than in files
5894
+ */
5895
+ inlinedRows: number;
5896
+ /**
5897
+ * Commits still in the dataset's history
5898
+ */
5899
+ retainedSnapshots: number;
5900
+ partitionBy: Array<string>;
5901
+ warnings: Array<{
5902
+ code: "partitioned-small-dataset";
5903
+ message: string;
5904
+ }>;
5905
+ /**
5906
+ * Ingested changes waiting or refused; null when there are none
5907
+ */
5908
+ ingest: {
5909
+ pendingDeliveries: number;
5910
+ pendingChanges: number;
5911
+ /**
5912
+ * When the oldest waiting delivery arrived
5913
+ */
5914
+ oldestReceivedAt: string | null;
5915
+ /**
5916
+ * Deliveries refused when written, kept for a week to read and send again
5917
+ */
5918
+ rejectedDeliveries: number;
5919
+ } | null;
5920
+ }>;
5921
+ };
5922
+ };
5923
+ export type GetLakeHealthResponse = GetLakeHealthResponses[keyof GetLakeHealthResponses];
5730
5924
  export type ListSyncsData = {
5731
5925
  body?: never;
5732
5926
  path?: never;
@@ -5772,6 +5966,7 @@ export type ListSyncsResponses = {
5772
5966
  datasetId: string;
5773
5967
  mode: "snapshot" | "append" | "merge";
5774
5968
  status: "queued" | "running" | "succeeded" | "failed" | "cancelled";
5969
+ attempt: number;
5775
5970
  queuedAt: string;
5776
5971
  startedAt?: string;
5777
5972
  finishedAt?: string;
@@ -5857,6 +6052,7 @@ export type GetSyncResponses = {
5857
6052
  datasetId: string;
5858
6053
  mode: "snapshot" | "append" | "merge";
5859
6054
  status: "queued" | "running" | "succeeded" | "failed" | "cancelled";
6055
+ attempt: number;
5860
6056
  queuedAt: string;
5861
6057
  startedAt?: string;
5862
6058
  finishedAt?: string;
@@ -5928,6 +6124,7 @@ export type ListSyncRunsResponses = {
5928
6124
  datasetId: string;
5929
6125
  mode: "snapshot" | "append" | "merge";
5930
6126
  status: "queued" | "running" | "succeeded" | "failed" | "cancelled";
6127
+ attempt: number;
5931
6128
  queuedAt: string;
5932
6129
  startedAt?: string;
5933
6130
  finishedAt?: string;
@@ -6071,6 +6268,7 @@ export type ListPipelinesResponses = {
6071
6268
  projectId: string;
6072
6269
  pipelineId: string;
6073
6270
  status: "queued" | "running" | "succeeded" | "failed" | "cancelled";
6271
+ attempt: number;
6074
6272
  queuedAt: string;
6075
6273
  startedAt?: string;
6076
6274
  finishedAt?: string;
@@ -6176,6 +6374,7 @@ export type GetPipelineResponses = {
6176
6374
  projectId: string;
6177
6375
  pipelineId: string;
6178
6376
  status: "queued" | "running" | "succeeded" | "failed" | "cancelled";
6377
+ attempt: number;
6179
6378
  queuedAt: string;
6180
6379
  startedAt?: string;
6181
6380
  finishedAt?: string;
@@ -6241,6 +6440,7 @@ export type ListPipelineRunsResponses = {
6241
6440
  projectId: string;
6242
6441
  pipelineId: string;
6243
6442
  status: "queued" | "running" | "succeeded" | "failed" | "cancelled";
6443
+ attempt: number;
6244
6444
  queuedAt: string;
6245
6445
  startedAt?: string;
6246
6446
  finishedAt?: string;
@@ -6308,6 +6508,7 @@ export type GetPipelineRunResponses = {
6308
6508
  projectId: string;
6309
6509
  pipelineId: string;
6310
6510
  status: "queued" | "running" | "succeeded" | "failed" | "cancelled";
6511
+ attempt: number;
6311
6512
  queuedAt: string;
6312
6513
  startedAt?: string;
6313
6514
  finishedAt?: string;
@@ -7321,7 +7522,7 @@ export type GetWorkflowAgentNodeExecutionResponses = {
7321
7522
  } | {
7322
7523
  kind: "error";
7323
7524
  error: {
7324
- code: "action.phase_failed" | "action.read_conflict" | "action.rejected" | "action.run_in_progress" | "action.timeout" | "agent.approval_authority_lost" | "agent.context_limit_exceeded" | "agent.execution_failed" | "agent.step_limit_reached" | "ai.usage_limit_exceeded" | "ai.usage_limit_unavailable" | "connector.adapter_invalid" | "connector.authorization_invalid" | "connector.authorization_required" | "connector.configuration_invalid" | "connector.credentials_unavailable" | "connector.not_found" | "connector.operation_conflict" | "connector.operation_in_progress" | "connector.provider_failed" | "connector.provider_unavailable" | "connector.replacement_required" | "connector.revocation_pending" | "dataset.not_found" | "dataset.version_incompatible" | "dataset.version_not_found" | "dataset.version_read_inconsistent" | "event.delivery_failed" | "internal.unexpected" | "queue.enqueue_failed" | "object.not_found" | "object.unique_violation" | "pipeline.step_failed" | "projection.definition_invalid" | "projection.execution_failed" | "projection.not_found" | "projection.run_already_terminal" | "projection.run_identity_mismatch" | "runtime.cancelled" | "runtime.stopping" | "vector.model_unavailable" | "vector.response_invalid" | "vector.outcome_unknown" | "storage.unavailable" | "sync.execution_failed" | "webhook.delivery_failed" | "webhook.delivery_rejected" | "workflow.node_failed";
7525
+ code: "action.phase_failed" | "action.read_conflict" | "action.rejected" | "action.run_in_progress" | "action.timeout" | "agent.approval_authority_lost" | "agent.context_limit_exceeded" | "agent.execution_failed" | "agent.step_limit_reached" | "ai.usage_limit_exceeded" | "ai.usage_limit_unavailable" | "connector.adapter_invalid" | "connector.authorization_invalid" | "connector.authorization_required" | "connector.configuration_invalid" | "connector.credentials_unavailable" | "connector.not_found" | "connector.operation_conflict" | "connector.operation_in_progress" | "connector.provider_failed" | "connector.provider_unavailable" | "connector.replacement_required" | "connector.revocation_pending" | "dataset.change_refused" | "dataset.not_found" | "dataset.version_incompatible" | "dataset.version_not_found" | "dataset.version_read_inconsistent" | "event.delivery_failed" | "internal.unexpected" | "queue.enqueue_failed" | "object.not_found" | "object.unique_violation" | "pipeline.step_failed" | "projection.definition_invalid" | "projection.execution_failed" | "projection.not_found" | "projection.run_already_terminal" | "projection.run_identity_mismatch" | "runtime.cancelled" | "runtime.stopping" | "vector.model_unavailable" | "vector.response_invalid" | "vector.outcome_unknown" | "storage.unavailable" | "sync.execution_failed" | "webhook.delivery_failed" | "webhook.delivery_rejected" | "workflow.node_failed";
7325
7526
  message: string;
7326
7527
  retryable: boolean;
7327
7528
  at: string;
@@ -8422,6 +8623,14 @@ export type ExchangeSharedAccessResponses = {
8422
8623
  expiresAt: string;
8423
8624
  absoluteExpiresAt: string;
8424
8625
  csrfToken: string;
8626
+ /**
8627
+ * Who the visitor is in this session: the author id of the comments they write as a guest
8628
+ */
8629
+ guestId: string;
8630
+ /**
8631
+ * The name the visitor gave, which their comments and live presence carry
8632
+ */
8633
+ guestName?: string;
8425
8634
  };
8426
8635
  };
8427
8636
  export type ExchangeSharedAccessResponse = ExchangeSharedAccessResponses[keyof ExchangeSharedAccessResponses];
@@ -8458,9 +8667,78 @@ export type GetSharedAccessSessionResponses = {
8458
8667
  expiresAt: string;
8459
8668
  absoluteExpiresAt: string;
8460
8669
  csrfToken: string;
8670
+ /**
8671
+ * Who the visitor is in this session: the author id of the comments they write as a guest
8672
+ */
8673
+ guestId: string;
8674
+ /**
8675
+ * The name the visitor gave, which their comments and live presence carry
8676
+ */
8677
+ guestName?: string;
8461
8678
  };
8462
8679
  };
8463
8680
  export type GetSharedAccessSessionResponse = GetSharedAccessSessionResponses[keyof GetSharedAccessSessionResponses];
8681
+ export type SetSharedAccessGuestNameData = {
8682
+ body: {
8683
+ /**
8684
+ * The visitor's name, on one line: 1 to 60 characters once its spaces are collapsed, without control or direction marks
8685
+ */
8686
+ name: string;
8687
+ };
8688
+ path: {
8689
+ grantId: string;
8690
+ };
8691
+ query?: never;
8692
+ url: "/api/shared-access/{grantId}/name";
8693
+ };
8694
+ export type SetSharedAccessGuestNameErrors = {
8695
+ /**
8696
+ * Response for status 400
8697
+ */
8698
+ 400: {
8699
+ error: string;
8700
+ };
8701
+ /**
8702
+ * Response for status 401
8703
+ */
8704
+ 401: {
8705
+ error: string;
8706
+ };
8707
+ /**
8708
+ * Response for status 403
8709
+ */
8710
+ 403: {
8711
+ error: string;
8712
+ };
8713
+ /**
8714
+ * Response for status 503
8715
+ */
8716
+ 503: {
8717
+ error: string;
8718
+ };
8719
+ };
8720
+ export type SetSharedAccessGuestNameError = SetSharedAccessGuestNameErrors[keyof SetSharedAccessGuestNameErrors];
8721
+ export type SetSharedAccessGuestNameResponses = {
8722
+ /**
8723
+ * Response for status 200
8724
+ */
8725
+ 200: {
8726
+ grantId: string;
8727
+ destinationPath: string;
8728
+ expiresAt: string;
8729
+ absoluteExpiresAt: string;
8730
+ csrfToken: string;
8731
+ /**
8732
+ * Who the visitor is in this session: the author id of the comments they write as a guest
8733
+ */
8734
+ guestId: string;
8735
+ /**
8736
+ * The name the visitor gave, which their comments and live presence carry
8737
+ */
8738
+ guestName?: string;
8739
+ };
8740
+ };
8741
+ export type SetSharedAccessGuestNameResponse = SetSharedAccessGuestNameResponses[keyof SetSharedAccessGuestNameResponses];
8464
8742
  export type SignOutSharedAccessData = {
8465
8743
  body?: never;
8466
8744
  path: {
@@ -9479,7 +9757,7 @@ export type RequestActionErrors = {
9479
9757
  /**
9480
9758
  * Stable machine-readable failure code for programmatic handling.
9481
9759
  */
9482
- code: "action.phase_failed" | "action.read_conflict" | "action.rejected" | "action.run_in_progress" | "action.timeout" | "agent.approval_authority_lost" | "agent.context_limit_exceeded" | "agent.execution_failed" | "agent.step_limit_reached" | "ai.usage_limit_exceeded" | "ai.usage_limit_unavailable" | "connector.adapter_invalid" | "connector.authorization_invalid" | "connector.authorization_required" | "connector.configuration_invalid" | "connector.credentials_unavailable" | "connector.not_found" | "connector.operation_conflict" | "connector.operation_in_progress" | "connector.provider_failed" | "connector.provider_unavailable" | "connector.replacement_required" | "connector.revocation_pending" | "dataset.not_found" | "dataset.version_incompatible" | "dataset.version_not_found" | "dataset.version_read_inconsistent" | "event.delivery_failed" | "internal.unexpected" | "queue.enqueue_failed" | "object.not_found" | "object.unique_violation" | "pipeline.step_failed" | "projection.definition_invalid" | "projection.execution_failed" | "projection.not_found" | "projection.run_already_terminal" | "projection.run_identity_mismatch" | "runtime.cancelled" | "runtime.stopping" | "vector.model_unavailable" | "vector.response_invalid" | "vector.outcome_unknown" | "storage.unavailable" | "sync.execution_failed" | "webhook.delivery_failed" | "webhook.delivery_rejected" | "workflow.node_failed";
9760
+ code: "action.phase_failed" | "action.read_conflict" | "action.rejected" | "action.run_in_progress" | "action.timeout" | "agent.approval_authority_lost" | "agent.context_limit_exceeded" | "agent.execution_failed" | "agent.step_limit_reached" | "ai.usage_limit_exceeded" | "ai.usage_limit_unavailable" | "connector.adapter_invalid" | "connector.authorization_invalid" | "connector.authorization_required" | "connector.configuration_invalid" | "connector.credentials_unavailable" | "connector.not_found" | "connector.operation_conflict" | "connector.operation_in_progress" | "connector.provider_failed" | "connector.provider_unavailable" | "connector.replacement_required" | "connector.revocation_pending" | "dataset.change_refused" | "dataset.not_found" | "dataset.version_incompatible" | "dataset.version_not_found" | "dataset.version_read_inconsistent" | "event.delivery_failed" | "internal.unexpected" | "queue.enqueue_failed" | "object.not_found" | "object.unique_violation" | "pipeline.step_failed" | "projection.definition_invalid" | "projection.execution_failed" | "projection.not_found" | "projection.run_already_terminal" | "projection.run_identity_mismatch" | "runtime.cancelled" | "runtime.stopping" | "vector.model_unavailable" | "vector.response_invalid" | "vector.outcome_unknown" | "storage.unavailable" | "sync.execution_failed" | "webhook.delivery_failed" | "webhook.delivery_rejected" | "workflow.node_failed";
9483
9761
  };
9484
9762
  /**
9485
9763
  * Response for status 503
@@ -11039,7 +11317,7 @@ export type ListAgentThreadMessagesResponses = {
11039
11317
  } | {
11040
11318
  kind: "error";
11041
11319
  error: {
11042
- code: "action.phase_failed" | "action.read_conflict" | "action.rejected" | "action.run_in_progress" | "action.timeout" | "agent.approval_authority_lost" | "agent.context_limit_exceeded" | "agent.execution_failed" | "agent.step_limit_reached" | "ai.usage_limit_exceeded" | "ai.usage_limit_unavailable" | "connector.adapter_invalid" | "connector.authorization_invalid" | "connector.authorization_required" | "connector.configuration_invalid" | "connector.credentials_unavailable" | "connector.not_found" | "connector.operation_conflict" | "connector.operation_in_progress" | "connector.provider_failed" | "connector.provider_unavailable" | "connector.replacement_required" | "connector.revocation_pending" | "dataset.not_found" | "dataset.version_incompatible" | "dataset.version_not_found" | "dataset.version_read_inconsistent" | "event.delivery_failed" | "internal.unexpected" | "queue.enqueue_failed" | "object.not_found" | "object.unique_violation" | "pipeline.step_failed" | "projection.definition_invalid" | "projection.execution_failed" | "projection.not_found" | "projection.run_already_terminal" | "projection.run_identity_mismatch" | "runtime.cancelled" | "runtime.stopping" | "vector.model_unavailable" | "vector.response_invalid" | "vector.outcome_unknown" | "storage.unavailable" | "sync.execution_failed" | "webhook.delivery_failed" | "webhook.delivery_rejected" | "workflow.node_failed";
11320
+ code: "action.phase_failed" | "action.read_conflict" | "action.rejected" | "action.run_in_progress" | "action.timeout" | "agent.approval_authority_lost" | "agent.context_limit_exceeded" | "agent.execution_failed" | "agent.step_limit_reached" | "ai.usage_limit_exceeded" | "ai.usage_limit_unavailable" | "connector.adapter_invalid" | "connector.authorization_invalid" | "connector.authorization_required" | "connector.configuration_invalid" | "connector.credentials_unavailable" | "connector.not_found" | "connector.operation_conflict" | "connector.operation_in_progress" | "connector.provider_failed" | "connector.provider_unavailable" | "connector.replacement_required" | "connector.revocation_pending" | "dataset.change_refused" | "dataset.not_found" | "dataset.version_incompatible" | "dataset.version_not_found" | "dataset.version_read_inconsistent" | "event.delivery_failed" | "internal.unexpected" | "queue.enqueue_failed" | "object.not_found" | "object.unique_violation" | "pipeline.step_failed" | "projection.definition_invalid" | "projection.execution_failed" | "projection.not_found" | "projection.run_already_terminal" | "projection.run_identity_mismatch" | "runtime.cancelled" | "runtime.stopping" | "vector.model_unavailable" | "vector.response_invalid" | "vector.outcome_unknown" | "storage.unavailable" | "sync.execution_failed" | "webhook.delivery_failed" | "webhook.delivery_rejected" | "workflow.node_failed";
11043
11321
  message: string;
11044
11322
  retryable: boolean;
11045
11323
  at: string;
@@ -12433,6 +12711,34 @@ export type HeadAgentChildFileContentResponses = {
12433
12711
  */
12434
12712
  206: unknown;
12435
12713
  };
12714
+ export type ListAgentComputersData = {
12715
+ body?: never;
12716
+ path?: never;
12717
+ query?: never;
12718
+ url: "/api/agent-computers";
12719
+ };
12720
+ export type ListAgentComputersErrors = {
12721
+ /**
12722
+ * Response for status 501
12723
+ */
12724
+ 501: {
12725
+ error: string;
12726
+ };
12727
+ };
12728
+ export type ListAgentComputersError = ListAgentComputersErrors[keyof ListAgentComputersErrors];
12729
+ export type ListAgentComputersResponses = {
12730
+ /**
12731
+ * Response for status 200
12732
+ */
12733
+ 200: {
12734
+ computers: Array<{
12735
+ id: string;
12736
+ name: string;
12737
+ folders: Array<string>;
12738
+ }>;
12739
+ };
12740
+ };
12741
+ export type ListAgentComputersResponse = ListAgentComputersResponses[keyof ListAgentComputersResponses];
12436
12742
  export type MoveAgentThreadToCloudData = {
12437
12743
  body?: never;
12438
12744
  path: {
@@ -13119,7 +13425,7 @@ export type ListAgentThreadApprovalsResponses = {
13119
13425
  } | {
13120
13426
  kind: "error";
13121
13427
  error: {
13122
- code: "action.phase_failed" | "action.read_conflict" | "action.rejected" | "action.run_in_progress" | "action.timeout" | "agent.approval_authority_lost" | "agent.context_limit_exceeded" | "agent.execution_failed" | "agent.step_limit_reached" | "ai.usage_limit_exceeded" | "ai.usage_limit_unavailable" | "connector.adapter_invalid" | "connector.authorization_invalid" | "connector.authorization_required" | "connector.configuration_invalid" | "connector.credentials_unavailable" | "connector.not_found" | "connector.operation_conflict" | "connector.operation_in_progress" | "connector.provider_failed" | "connector.provider_unavailable" | "connector.replacement_required" | "connector.revocation_pending" | "dataset.not_found" | "dataset.version_incompatible" | "dataset.version_not_found" | "dataset.version_read_inconsistent" | "event.delivery_failed" | "internal.unexpected" | "queue.enqueue_failed" | "object.not_found" | "object.unique_violation" | "pipeline.step_failed" | "projection.definition_invalid" | "projection.execution_failed" | "projection.not_found" | "projection.run_already_terminal" | "projection.run_identity_mismatch" | "runtime.cancelled" | "runtime.stopping" | "vector.model_unavailable" | "vector.response_invalid" | "vector.outcome_unknown" | "storage.unavailable" | "sync.execution_failed" | "webhook.delivery_failed" | "webhook.delivery_rejected" | "workflow.node_failed";
13428
+ code: "action.phase_failed" | "action.read_conflict" | "action.rejected" | "action.run_in_progress" | "action.timeout" | "agent.approval_authority_lost" | "agent.context_limit_exceeded" | "agent.execution_failed" | "agent.step_limit_reached" | "ai.usage_limit_exceeded" | "ai.usage_limit_unavailable" | "connector.adapter_invalid" | "connector.authorization_invalid" | "connector.authorization_required" | "connector.configuration_invalid" | "connector.credentials_unavailable" | "connector.not_found" | "connector.operation_conflict" | "connector.operation_in_progress" | "connector.provider_failed" | "connector.provider_unavailable" | "connector.replacement_required" | "connector.revocation_pending" | "dataset.change_refused" | "dataset.not_found" | "dataset.version_incompatible" | "dataset.version_not_found" | "dataset.version_read_inconsistent" | "event.delivery_failed" | "internal.unexpected" | "queue.enqueue_failed" | "object.not_found" | "object.unique_violation" | "pipeline.step_failed" | "projection.definition_invalid" | "projection.execution_failed" | "projection.not_found" | "projection.run_already_terminal" | "projection.run_identity_mismatch" | "runtime.cancelled" | "runtime.stopping" | "vector.model_unavailable" | "vector.response_invalid" | "vector.outcome_unknown" | "storage.unavailable" | "sync.execution_failed" | "webhook.delivery_failed" | "webhook.delivery_rejected" | "workflow.node_failed";
13123
13429
  message: string;
13124
13430
  retryable: boolean;
13125
13431
  at: string;
@@ -13268,7 +13574,7 @@ export type DecideAgentApprovalResponses = {
13268
13574
  } | {
13269
13575
  kind: "error";
13270
13576
  error: {
13271
- code: "action.phase_failed" | "action.read_conflict" | "action.rejected" | "action.run_in_progress" | "action.timeout" | "agent.approval_authority_lost" | "agent.context_limit_exceeded" | "agent.execution_failed" | "agent.step_limit_reached" | "ai.usage_limit_exceeded" | "ai.usage_limit_unavailable" | "connector.adapter_invalid" | "connector.authorization_invalid" | "connector.authorization_required" | "connector.configuration_invalid" | "connector.credentials_unavailable" | "connector.not_found" | "connector.operation_conflict" | "connector.operation_in_progress" | "connector.provider_failed" | "connector.provider_unavailable" | "connector.replacement_required" | "connector.revocation_pending" | "dataset.not_found" | "dataset.version_incompatible" | "dataset.version_not_found" | "dataset.version_read_inconsistent" | "event.delivery_failed" | "internal.unexpected" | "queue.enqueue_failed" | "object.not_found" | "object.unique_violation" | "pipeline.step_failed" | "projection.definition_invalid" | "projection.execution_failed" | "projection.not_found" | "projection.run_already_terminal" | "projection.run_identity_mismatch" | "runtime.cancelled" | "runtime.stopping" | "vector.model_unavailable" | "vector.response_invalid" | "vector.outcome_unknown" | "storage.unavailable" | "sync.execution_failed" | "webhook.delivery_failed" | "webhook.delivery_rejected" | "workflow.node_failed";
13577
+ code: "action.phase_failed" | "action.read_conflict" | "action.rejected" | "action.run_in_progress" | "action.timeout" | "agent.approval_authority_lost" | "agent.context_limit_exceeded" | "agent.execution_failed" | "agent.step_limit_reached" | "ai.usage_limit_exceeded" | "ai.usage_limit_unavailable" | "connector.adapter_invalid" | "connector.authorization_invalid" | "connector.authorization_required" | "connector.configuration_invalid" | "connector.credentials_unavailable" | "connector.not_found" | "connector.operation_conflict" | "connector.operation_in_progress" | "connector.provider_failed" | "connector.provider_unavailable" | "connector.replacement_required" | "connector.revocation_pending" | "dataset.change_refused" | "dataset.not_found" | "dataset.version_incompatible" | "dataset.version_not_found" | "dataset.version_read_inconsistent" | "event.delivery_failed" | "internal.unexpected" | "queue.enqueue_failed" | "object.not_found" | "object.unique_violation" | "pipeline.step_failed" | "projection.definition_invalid" | "projection.execution_failed" | "projection.not_found" | "projection.run_already_terminal" | "projection.run_identity_mismatch" | "runtime.cancelled" | "runtime.stopping" | "vector.model_unavailable" | "vector.response_invalid" | "vector.outcome_unknown" | "storage.unavailable" | "sync.execution_failed" | "webhook.delivery_failed" | "webhook.delivery_rejected" | "workflow.node_failed";
13272
13578
  message: string;
13273
13579
  retryable: boolean;
13274
13580
  at: string;
@@ -13489,7 +13795,7 @@ export type ListAgentApprovalsResponses = {
13489
13795
  } | {
13490
13796
  kind: "error";
13491
13797
  error: {
13492
- code: "action.phase_failed" | "action.read_conflict" | "action.rejected" | "action.run_in_progress" | "action.timeout" | "agent.approval_authority_lost" | "agent.context_limit_exceeded" | "agent.execution_failed" | "agent.step_limit_reached" | "ai.usage_limit_exceeded" | "ai.usage_limit_unavailable" | "connector.adapter_invalid" | "connector.authorization_invalid" | "connector.authorization_required" | "connector.configuration_invalid" | "connector.credentials_unavailable" | "connector.not_found" | "connector.operation_conflict" | "connector.operation_in_progress" | "connector.provider_failed" | "connector.provider_unavailable" | "connector.replacement_required" | "connector.revocation_pending" | "dataset.not_found" | "dataset.version_incompatible" | "dataset.version_not_found" | "dataset.version_read_inconsistent" | "event.delivery_failed" | "internal.unexpected" | "queue.enqueue_failed" | "object.not_found" | "object.unique_violation" | "pipeline.step_failed" | "projection.definition_invalid" | "projection.execution_failed" | "projection.not_found" | "projection.run_already_terminal" | "projection.run_identity_mismatch" | "runtime.cancelled" | "runtime.stopping" | "vector.model_unavailable" | "vector.response_invalid" | "vector.outcome_unknown" | "storage.unavailable" | "sync.execution_failed" | "webhook.delivery_failed" | "webhook.delivery_rejected" | "workflow.node_failed";
13798
+ code: "action.phase_failed" | "action.read_conflict" | "action.rejected" | "action.run_in_progress" | "action.timeout" | "agent.approval_authority_lost" | "agent.context_limit_exceeded" | "agent.execution_failed" | "agent.step_limit_reached" | "ai.usage_limit_exceeded" | "ai.usage_limit_unavailable" | "connector.adapter_invalid" | "connector.authorization_invalid" | "connector.authorization_required" | "connector.configuration_invalid" | "connector.credentials_unavailable" | "connector.not_found" | "connector.operation_conflict" | "connector.operation_in_progress" | "connector.provider_failed" | "connector.provider_unavailable" | "connector.replacement_required" | "connector.revocation_pending" | "dataset.change_refused" | "dataset.not_found" | "dataset.version_incompatible" | "dataset.version_not_found" | "dataset.version_read_inconsistent" | "event.delivery_failed" | "internal.unexpected" | "queue.enqueue_failed" | "object.not_found" | "object.unique_violation" | "pipeline.step_failed" | "projection.definition_invalid" | "projection.execution_failed" | "projection.not_found" | "projection.run_already_terminal" | "projection.run_identity_mismatch" | "runtime.cancelled" | "runtime.stopping" | "vector.model_unavailable" | "vector.response_invalid" | "vector.outcome_unknown" | "storage.unavailable" | "sync.execution_failed" | "webhook.delivery_failed" | "webhook.delivery_rejected" | "workflow.node_failed";
13493
13799
  message: string;
13494
13800
  retryable: boolean;
13495
13801
  at: string;
@@ -13730,7 +14036,7 @@ export type ListObservedAgentThreadMessagesResponses = {
13730
14036
  } | {
13731
14037
  kind: "error";
13732
14038
  error: {
13733
- code: "action.phase_failed" | "action.read_conflict" | "action.rejected" | "action.run_in_progress" | "action.timeout" | "agent.approval_authority_lost" | "agent.context_limit_exceeded" | "agent.execution_failed" | "agent.step_limit_reached" | "ai.usage_limit_exceeded" | "ai.usage_limit_unavailable" | "connector.adapter_invalid" | "connector.authorization_invalid" | "connector.authorization_required" | "connector.configuration_invalid" | "connector.credentials_unavailable" | "connector.not_found" | "connector.operation_conflict" | "connector.operation_in_progress" | "connector.provider_failed" | "connector.provider_unavailable" | "connector.replacement_required" | "connector.revocation_pending" | "dataset.not_found" | "dataset.version_incompatible" | "dataset.version_not_found" | "dataset.version_read_inconsistent" | "event.delivery_failed" | "internal.unexpected" | "queue.enqueue_failed" | "object.not_found" | "object.unique_violation" | "pipeline.step_failed" | "projection.definition_invalid" | "projection.execution_failed" | "projection.not_found" | "projection.run_already_terminal" | "projection.run_identity_mismatch" | "runtime.cancelled" | "runtime.stopping" | "vector.model_unavailable" | "vector.response_invalid" | "vector.outcome_unknown" | "storage.unavailable" | "sync.execution_failed" | "webhook.delivery_failed" | "webhook.delivery_rejected" | "workflow.node_failed";
14039
+ code: "action.phase_failed" | "action.read_conflict" | "action.rejected" | "action.run_in_progress" | "action.timeout" | "agent.approval_authority_lost" | "agent.context_limit_exceeded" | "agent.execution_failed" | "agent.step_limit_reached" | "ai.usage_limit_exceeded" | "ai.usage_limit_unavailable" | "connector.adapter_invalid" | "connector.authorization_invalid" | "connector.authorization_required" | "connector.configuration_invalid" | "connector.credentials_unavailable" | "connector.not_found" | "connector.operation_conflict" | "connector.operation_in_progress" | "connector.provider_failed" | "connector.provider_unavailable" | "connector.replacement_required" | "connector.revocation_pending" | "dataset.change_refused" | "dataset.not_found" | "dataset.version_incompatible" | "dataset.version_not_found" | "dataset.version_read_inconsistent" | "event.delivery_failed" | "internal.unexpected" | "queue.enqueue_failed" | "object.not_found" | "object.unique_violation" | "pipeline.step_failed" | "projection.definition_invalid" | "projection.execution_failed" | "projection.not_found" | "projection.run_already_terminal" | "projection.run_identity_mismatch" | "runtime.cancelled" | "runtime.stopping" | "vector.model_unavailable" | "vector.response_invalid" | "vector.outcome_unknown" | "storage.unavailable" | "sync.execution_failed" | "webhook.delivery_failed" | "webhook.delivery_rejected" | "workflow.node_failed";
13734
14040
  message: string;
13735
14041
  retryable: boolean;
13736
14042
  at: string;
@@ -14504,7 +14810,7 @@ export type ListArtifactsData = {
14504
14810
  path?: never;
14505
14811
  query?: {
14506
14812
  /**
14507
- * Only artifacts with a version the Agent published in this thread
14813
+ * Only artifacts this conversation shares: the Agent wrote them in it
14508
14814
  */
14509
14815
  thread?: string;
14510
14816
  /**
@@ -14523,18 +14829,23 @@ export type ListArtifactsErrors = {
14523
14829
  400: {
14524
14830
  error: string;
14525
14831
  /**
14526
- * 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.
14832
+ * 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.
14527
14833
  */
14528
14834
  code?: string;
14529
14835
  /**
14530
- * With artifact_moved: the latest version and who published it
14836
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
14531
14837
  */
14532
14838
  latest?: {
14533
14839
  version: number;
14840
+ revision: number;
14534
14841
  author: {
14535
14842
  type: "user" | "serviceAccount" | "system";
14536
14843
  id: string;
14537
14844
  };
14845
+ frozenBy?: {
14846
+ type: "user" | "serviceAccount" | "system";
14847
+ id: string;
14848
+ };
14538
14849
  };
14539
14850
  };
14540
14851
  /**
@@ -14543,18 +14854,23 @@ export type ListArtifactsErrors = {
14543
14854
  501: {
14544
14855
  error: string;
14545
14856
  /**
14546
- * 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.
14857
+ * 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.
14547
14858
  */
14548
14859
  code?: string;
14549
14860
  /**
14550
- * With artifact_moved: the latest version and who published it
14861
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
14551
14862
  */
14552
14863
  latest?: {
14553
14864
  version: number;
14865
+ revision: number;
14554
14866
  author: {
14555
14867
  type: "user" | "serviceAccount" | "system";
14556
14868
  id: string;
14557
14869
  };
14870
+ frozenBy?: {
14871
+ type: "user" | "serviceAccount" | "system";
14872
+ id: string;
14873
+ };
14558
14874
  };
14559
14875
  };
14560
14876
  };
@@ -14574,7 +14890,14 @@ export type ListArtifactsResponses = {
14574
14890
  id: string;
14575
14891
  };
14576
14892
  latestVersion: number;
14893
+ /**
14894
+ * 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
14895
+ */
14896
+ revision: number;
14577
14897
  createdAt: string;
14898
+ /**
14899
+ * When the artifact last changed
14900
+ */
14578
14901
  updatedAt: string;
14579
14902
  }>;
14580
14903
  hasMore: boolean;
@@ -14615,18 +14938,23 @@ export type CreateArtifactErrors = {
14615
14938
  400: {
14616
14939
  error: string;
14617
14940
  /**
14618
- * 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.
14941
+ * 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.
14619
14942
  */
14620
14943
  code?: string;
14621
14944
  /**
14622
- * With artifact_moved: the latest version and who published it
14945
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
14623
14946
  */
14624
14947
  latest?: {
14625
14948
  version: number;
14949
+ revision: number;
14626
14950
  author: {
14627
14951
  type: "user" | "serviceAccount" | "system";
14628
14952
  id: string;
14629
14953
  };
14954
+ frozenBy?: {
14955
+ type: "user" | "serviceAccount" | "system";
14956
+ id: string;
14957
+ };
14630
14958
  };
14631
14959
  };
14632
14960
  /**
@@ -14635,18 +14963,23 @@ export type CreateArtifactErrors = {
14635
14963
  403: {
14636
14964
  error: string;
14637
14965
  /**
14638
- * 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.
14966
+ * 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.
14639
14967
  */
14640
14968
  code?: string;
14641
14969
  /**
14642
- * With artifact_moved: the latest version and who published it
14970
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
14643
14971
  */
14644
14972
  latest?: {
14645
14973
  version: number;
14974
+ revision: number;
14646
14975
  author: {
14647
14976
  type: "user" | "serviceAccount" | "system";
14648
14977
  id: string;
14649
14978
  };
14979
+ frozenBy?: {
14980
+ type: "user" | "serviceAccount" | "system";
14981
+ id: string;
14982
+ };
14650
14983
  };
14651
14984
  };
14652
14985
  /**
@@ -14655,18 +14988,23 @@ export type CreateArtifactErrors = {
14655
14988
  404: {
14656
14989
  error: string;
14657
14990
  /**
14658
- * 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.
14991
+ * 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.
14659
14992
  */
14660
14993
  code?: string;
14661
14994
  /**
14662
- * With artifact_moved: the latest version and who published it
14995
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
14663
14996
  */
14664
14997
  latest?: {
14665
14998
  version: number;
14999
+ revision: number;
14666
15000
  author: {
14667
15001
  type: "user" | "serviceAccount" | "system";
14668
15002
  id: string;
14669
15003
  };
15004
+ frozenBy?: {
15005
+ type: "user" | "serviceAccount" | "system";
15006
+ id: string;
15007
+ };
14670
15008
  };
14671
15009
  };
14672
15010
  /**
@@ -14675,18 +15013,23 @@ export type CreateArtifactErrors = {
14675
15013
  409: {
14676
15014
  error: string;
14677
15015
  /**
14678
- * 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.
15016
+ * 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.
14679
15017
  */
14680
15018
  code?: string;
14681
15019
  /**
14682
- * With artifact_moved: the latest version and who published it
15020
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
14683
15021
  */
14684
15022
  latest?: {
14685
15023
  version: number;
15024
+ revision: number;
14686
15025
  author: {
14687
15026
  type: "user" | "serviceAccount" | "system";
14688
15027
  id: string;
14689
15028
  };
15029
+ frozenBy?: {
15030
+ type: "user" | "serviceAccount" | "system";
15031
+ id: string;
15032
+ };
14690
15033
  };
14691
15034
  };
14692
15035
  /**
@@ -14695,18 +15038,23 @@ export type CreateArtifactErrors = {
14695
15038
  501: {
14696
15039
  error: string;
14697
15040
  /**
14698
- * 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.
15041
+ * 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.
14699
15042
  */
14700
15043
  code?: string;
14701
15044
  /**
14702
- * With artifact_moved: the latest version and who published it
15045
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
14703
15046
  */
14704
15047
  latest?: {
14705
15048
  version: number;
15049
+ revision: number;
14706
15050
  author: {
14707
15051
  type: "user" | "serviceAccount" | "system";
14708
15052
  id: string;
14709
15053
  };
15054
+ frozenBy?: {
15055
+ type: "user" | "serviceAccount" | "system";
15056
+ id: string;
15057
+ };
14710
15058
  };
14711
15059
  };
14712
15060
  };
@@ -14726,12 +15074,27 @@ export type CreateArtifactResponses = {
14726
15074
  id: string;
14727
15075
  };
14728
15076
  latestVersion: number;
15077
+ /**
15078
+ * 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
15079
+ */
15080
+ revision: number;
14729
15081
  createdAt: string;
15082
+ /**
15083
+ * When the artifact last changed
15084
+ */
14730
15085
  updatedAt: string;
14731
15086
  };
14732
15087
  version: {
14733
15088
  artifactId: string;
14734
15089
  version: number;
15090
+ /**
15091
+ * The artifact's revision when this version last changed: the latest version's is the artifact's
15092
+ */
15093
+ revision: number;
15094
+ /**
15095
+ * Someone created this version: it never changes again. The latest version is open until then, and each write replaces its content
15096
+ */
15097
+ frozen: boolean;
14735
15098
  title: string;
14736
15099
  entry: string;
14737
15100
  files: Array<{
@@ -14787,11 +15150,19 @@ export type CreateArtifactResponses = {
14787
15150
  file: string;
14788
15151
  w: number;
14789
15152
  h: number;
15153
+ /**
15154
+ * What the board's preview is a picture of: a board kept as it was keeps it
15155
+ */
15156
+ renderKey?: string;
14790
15157
  } | {
14791
15158
  id: string;
14792
15159
  type: "section";
14793
15160
  title?: string;
14794
15161
  }>;
15162
+ /**
15163
+ * The modes each board has a preview in: both, or the one its theme.json pins
15164
+ */
15165
+ themes?: Array<"light" | "dark">;
14795
15166
  } | {
14796
15167
  kind: "file";
14797
15168
  mediaType: string;
@@ -14802,15 +15173,45 @@ export type CreateArtifactResponses = {
14802
15173
  at: string;
14803
15174
  resolvedVersion: number;
14804
15175
  }>;
15176
+ /**
15177
+ * Who last wrote its content
15178
+ */
14805
15179
  author: {
14806
15180
  type: "user" | "serviceAccount" | "system";
14807
15181
  id: string;
14808
15182
  };
15183
+ /**
15184
+ * The Agent turn and thread its content was last written from
15185
+ */
14809
15186
  origin?: {
14810
15187
  threadId: string;
14811
15188
  runId: string;
14812
15189
  };
15190
+ /**
15191
+ * When the version was opened
15192
+ */
14813
15193
  createdAt: string;
15194
+ /**
15195
+ * When its content was last written
15196
+ */
15197
+ updatedAt: string;
15198
+ /**
15199
+ * When it was created, which froze it
15200
+ */
15201
+ frozenAt?: string;
15202
+ /**
15203
+ * Who created it
15204
+ */
15205
+ frozenBy?: {
15206
+ type: "user" | "serviceAccount" | "system";
15207
+ id: string;
15208
+ };
15209
+ /**
15210
+ * 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
15211
+ */
15212
+ boardPreviews?: {
15213
+ [key: string]: "ready" | "pending" | "none";
15214
+ };
14814
15215
  };
14815
15216
  warnings: Array<{
14816
15217
  code: string;
@@ -14835,18 +15236,23 @@ export type DeleteArtifactErrors = {
14835
15236
  403: {
14836
15237
  error: string;
14837
15238
  /**
14838
- * 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.
15239
+ * 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.
14839
15240
  */
14840
15241
  code?: string;
14841
15242
  /**
14842
- * With artifact_moved: the latest version and who published it
15243
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
14843
15244
  */
14844
15245
  latest?: {
14845
15246
  version: number;
15247
+ revision: number;
14846
15248
  author: {
14847
15249
  type: "user" | "serviceAccount" | "system";
14848
15250
  id: string;
14849
15251
  };
15252
+ frozenBy?: {
15253
+ type: "user" | "serviceAccount" | "system";
15254
+ id: string;
15255
+ };
14850
15256
  };
14851
15257
  };
14852
15258
  /**
@@ -14855,18 +15261,23 @@ export type DeleteArtifactErrors = {
14855
15261
  404: {
14856
15262
  error: string;
14857
15263
  /**
14858
- * 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.
15264
+ * 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.
14859
15265
  */
14860
15266
  code?: string;
14861
15267
  /**
14862
- * With artifact_moved: the latest version and who published it
15268
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
14863
15269
  */
14864
15270
  latest?: {
14865
15271
  version: number;
15272
+ revision: number;
14866
15273
  author: {
14867
15274
  type: "user" | "serviceAccount" | "system";
14868
15275
  id: string;
14869
15276
  };
15277
+ frozenBy?: {
15278
+ type: "user" | "serviceAccount" | "system";
15279
+ id: string;
15280
+ };
14870
15281
  };
14871
15282
  };
14872
15283
  /**
@@ -14875,18 +15286,23 @@ export type DeleteArtifactErrors = {
14875
15286
  501: {
14876
15287
  error: string;
14877
15288
  /**
14878
- * 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.
15289
+ * 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.
14879
15290
  */
14880
15291
  code?: string;
14881
15292
  /**
14882
- * With artifact_moved: the latest version and who published it
15293
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
14883
15294
  */
14884
15295
  latest?: {
14885
15296
  version: number;
15297
+ revision: number;
14886
15298
  author: {
14887
15299
  type: "user" | "serviceAccount" | "system";
14888
15300
  id: string;
14889
15301
  };
15302
+ frozenBy?: {
15303
+ type: "user" | "serviceAccount" | "system";
15304
+ id: string;
15305
+ };
14890
15306
  };
14891
15307
  };
14892
15308
  };
@@ -14915,18 +15331,23 @@ export type GetArtifactErrors = {
14915
15331
  403: {
14916
15332
  error: string;
14917
15333
  /**
14918
- * 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.
15334
+ * 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.
14919
15335
  */
14920
15336
  code?: string;
14921
15337
  /**
14922
- * With artifact_moved: the latest version and who published it
15338
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
14923
15339
  */
14924
15340
  latest?: {
14925
15341
  version: number;
15342
+ revision: number;
14926
15343
  author: {
14927
15344
  type: "user" | "serviceAccount" | "system";
14928
15345
  id: string;
14929
15346
  };
15347
+ frozenBy?: {
15348
+ type: "user" | "serviceAccount" | "system";
15349
+ id: string;
15350
+ };
14930
15351
  };
14931
15352
  };
14932
15353
  /**
@@ -14935,18 +15356,23 @@ export type GetArtifactErrors = {
14935
15356
  404: {
14936
15357
  error: string;
14937
15358
  /**
14938
- * 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.
15359
+ * 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.
14939
15360
  */
14940
15361
  code?: string;
14941
15362
  /**
14942
- * With artifact_moved: the latest version and who published it
15363
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
14943
15364
  */
14944
15365
  latest?: {
14945
15366
  version: number;
15367
+ revision: number;
14946
15368
  author: {
14947
15369
  type: "user" | "serviceAccount" | "system";
14948
15370
  id: string;
14949
15371
  };
15372
+ frozenBy?: {
15373
+ type: "user" | "serviceAccount" | "system";
15374
+ id: string;
15375
+ };
14950
15376
  };
14951
15377
  };
14952
15378
  /**
@@ -14955,18 +15381,23 @@ export type GetArtifactErrors = {
14955
15381
  501: {
14956
15382
  error: string;
14957
15383
  /**
14958
- * 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.
15384
+ * 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.
14959
15385
  */
14960
15386
  code?: string;
14961
15387
  /**
14962
- * With artifact_moved: the latest version and who published it
15388
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
14963
15389
  */
14964
15390
  latest?: {
14965
15391
  version: number;
15392
+ revision: number;
14966
15393
  author: {
14967
15394
  type: "user" | "serviceAccount" | "system";
14968
15395
  id: string;
14969
15396
  };
15397
+ frozenBy?: {
15398
+ type: "user" | "serviceAccount" | "system";
15399
+ id: string;
15400
+ };
14970
15401
  };
14971
15402
  };
14972
15403
  };
@@ -14986,7 +15417,14 @@ export type GetArtifactResponses = {
14986
15417
  id: string;
14987
15418
  };
14988
15419
  latestVersion: number;
15420
+ /**
15421
+ * 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
15422
+ */
15423
+ revision: number;
14989
15424
  createdAt: string;
15425
+ /**
15426
+ * When the artifact last changed
15427
+ */
14990
15428
  updatedAt: string;
14991
15429
  };
14992
15430
  /**
@@ -14994,24 +15432,169 @@ export type GetArtifactResponses = {
14994
15432
  */
14995
15433
  versions: Array<{
14996
15434
  version: number;
15435
+ /**
15436
+ * The artifact's revision when this version last changed: the latest version's is the artifact's
15437
+ */
15438
+ revision: number;
15439
+ /**
15440
+ * Someone created this version: it never changes again. The latest version is open until then, and each write replaces its content
15441
+ */
15442
+ frozen: boolean;
14997
15443
  title: string;
15444
+ /**
15445
+ * Who last wrote its content
15446
+ */
14998
15447
  author: {
14999
15448
  type: "user" | "serviceAccount" | "system";
15000
15449
  id: string;
15001
15450
  };
15451
+ /**
15452
+ * The Agent turn and thread its content was last written from
15453
+ */
15002
15454
  origin?: {
15003
15455
  threadId: string;
15004
15456
  runId: string;
15005
15457
  };
15458
+ /**
15459
+ * When the version was opened
15460
+ */
15006
15461
  createdAt: string;
15462
+ /**
15463
+ * When its content was last written
15464
+ */
15465
+ updatedAt: string;
15466
+ /**
15467
+ * When it was created, which froze it
15468
+ */
15469
+ frozenAt?: string;
15470
+ /**
15471
+ * Who created it
15472
+ */
15473
+ frozenBy?: {
15474
+ type: "user" | "serviceAccount" | "system";
15475
+ id: string;
15476
+ };
15007
15477
  }>;
15008
15478
  /**
15009
- * 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
15479
+ * 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
15010
15480
  */
15011
15481
  access: "owner" | "update" | "read";
15012
15482
  };
15013
15483
  };
15014
15484
  export type GetArtifactResponse = GetArtifactResponses[keyof GetArtifactResponses];
15485
+ export type ListArtifactHoldersData = {
15486
+ body?: never;
15487
+ path: {
15488
+ artifactId: string;
15489
+ };
15490
+ query?: never;
15491
+ url: "/api/artifacts/{artifactId}/holders";
15492
+ };
15493
+ export type ListArtifactHoldersErrors = {
15494
+ /**
15495
+ * Response for status 403
15496
+ */
15497
+ 403: {
15498
+ error: string;
15499
+ /**
15500
+ * 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.
15501
+ */
15502
+ code?: string;
15503
+ /**
15504
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15505
+ */
15506
+ latest?: {
15507
+ version: number;
15508
+ revision: number;
15509
+ author: {
15510
+ type: "user" | "serviceAccount" | "system";
15511
+ id: string;
15512
+ };
15513
+ frozenBy?: {
15514
+ type: "user" | "serviceAccount" | "system";
15515
+ id: string;
15516
+ };
15517
+ };
15518
+ };
15519
+ /**
15520
+ * Response for status 404
15521
+ */
15522
+ 404: {
15523
+ error: string;
15524
+ /**
15525
+ * 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.
15526
+ */
15527
+ code?: string;
15528
+ /**
15529
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15530
+ */
15531
+ latest?: {
15532
+ version: number;
15533
+ revision: number;
15534
+ author: {
15535
+ type: "user" | "serviceAccount" | "system";
15536
+ id: string;
15537
+ };
15538
+ frozenBy?: {
15539
+ type: "user" | "serviceAccount" | "system";
15540
+ id: string;
15541
+ };
15542
+ };
15543
+ };
15544
+ /**
15545
+ * Response for status 501
15546
+ */
15547
+ 501: {
15548
+ error: string;
15549
+ /**
15550
+ * 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.
15551
+ */
15552
+ code?: string;
15553
+ /**
15554
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15555
+ */
15556
+ latest?: {
15557
+ version: number;
15558
+ revision: number;
15559
+ author: {
15560
+ type: "user" | "serviceAccount" | "system";
15561
+ id: string;
15562
+ };
15563
+ frozenBy?: {
15564
+ type: "user" | "serviceAccount" | "system";
15565
+ id: string;
15566
+ };
15567
+ };
15568
+ };
15569
+ };
15570
+ export type ListArtifactHoldersError = ListArtifactHoldersErrors[keyof ListArtifactHoldersErrors];
15571
+ export type ListArtifactHoldersResponses = {
15572
+ /**
15573
+ * Response for status 200
15574
+ */
15575
+ 200: {
15576
+ /**
15577
+ * The first 20 objects you read that hold the artifact
15578
+ */
15579
+ holders: Array<{
15580
+ objectTypeId: string;
15581
+ primaryId: string;
15582
+ /**
15583
+ * The property whose value holds the artifact
15584
+ */
15585
+ propertyId: string;
15586
+ /**
15587
+ * The object's value of its type's search title, when it has one you read
15588
+ */
15589
+ title?: string;
15590
+ }>;
15591
+ /**
15592
+ * More objects you read hold it
15593
+ */
15594
+ hasMore: boolean;
15595
+ };
15596
+ };
15597
+ export type ListArtifactHoldersResponse = ListArtifactHoldersResponses[keyof ListArtifactHoldersResponses];
15015
15598
  export type ClearArtifactStateData = {
15016
15599
  body?: never;
15017
15600
  path: {
@@ -15027,18 +15610,23 @@ export type ClearArtifactStateErrors = {
15027
15610
  403: {
15028
15611
  error: string;
15029
15612
  /**
15030
- * 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.
15613
+ * 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.
15031
15614
  */
15032
15615
  code?: string;
15033
15616
  /**
15034
- * With artifact_moved: the latest version and who published it
15617
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15035
15618
  */
15036
15619
  latest?: {
15037
15620
  version: number;
15621
+ revision: number;
15038
15622
  author: {
15039
15623
  type: "user" | "serviceAccount" | "system";
15040
15624
  id: string;
15041
15625
  };
15626
+ frozenBy?: {
15627
+ type: "user" | "serviceAccount" | "system";
15628
+ id: string;
15629
+ };
15042
15630
  };
15043
15631
  };
15044
15632
  /**
@@ -15047,18 +15635,23 @@ export type ClearArtifactStateErrors = {
15047
15635
  404: {
15048
15636
  error: string;
15049
15637
  /**
15050
- * 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.
15638
+ * 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.
15051
15639
  */
15052
15640
  code?: string;
15053
15641
  /**
15054
- * With artifact_moved: the latest version and who published it
15642
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15055
15643
  */
15056
15644
  latest?: {
15057
15645
  version: number;
15646
+ revision: number;
15058
15647
  author: {
15059
15648
  type: "user" | "serviceAccount" | "system";
15060
15649
  id: string;
15061
15650
  };
15651
+ frozenBy?: {
15652
+ type: "user" | "serviceAccount" | "system";
15653
+ id: string;
15654
+ };
15062
15655
  };
15063
15656
  };
15064
15657
  /**
@@ -15067,18 +15660,23 @@ export type ClearArtifactStateErrors = {
15067
15660
  501: {
15068
15661
  error: string;
15069
15662
  /**
15070
- * 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.
15663
+ * 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.
15071
15664
  */
15072
15665
  code?: string;
15073
15666
  /**
15074
- * With artifact_moved: the latest version and who published it
15667
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15075
15668
  */
15076
15669
  latest?: {
15077
15670
  version: number;
15671
+ revision: number;
15078
15672
  author: {
15079
15673
  type: "user" | "serviceAccount" | "system";
15080
15674
  id: string;
15081
15675
  };
15676
+ frozenBy?: {
15677
+ type: "user" | "serviceAccount" | "system";
15678
+ id: string;
15679
+ };
15082
15680
  };
15083
15681
  };
15084
15682
  };
@@ -15110,18 +15708,23 @@ export type GetArtifactStateErrors = {
15110
15708
  403: {
15111
15709
  error: string;
15112
15710
  /**
15113
- * 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.
15711
+ * 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.
15114
15712
  */
15115
15713
  code?: string;
15116
15714
  /**
15117
- * With artifact_moved: the latest version and who published it
15715
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15118
15716
  */
15119
15717
  latest?: {
15120
15718
  version: number;
15719
+ revision: number;
15121
15720
  author: {
15122
15721
  type: "user" | "serviceAccount" | "system";
15123
15722
  id: string;
15124
15723
  };
15724
+ frozenBy?: {
15725
+ type: "user" | "serviceAccount" | "system";
15726
+ id: string;
15727
+ };
15125
15728
  };
15126
15729
  };
15127
15730
  /**
@@ -15130,18 +15733,23 @@ export type GetArtifactStateErrors = {
15130
15733
  404: {
15131
15734
  error: string;
15132
15735
  /**
15133
- * 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.
15736
+ * 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.
15134
15737
  */
15135
15738
  code?: string;
15136
15739
  /**
15137
- * With artifact_moved: the latest version and who published it
15740
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15138
15741
  */
15139
15742
  latest?: {
15140
15743
  version: number;
15744
+ revision: number;
15141
15745
  author: {
15142
15746
  type: "user" | "serviceAccount" | "system";
15143
15747
  id: string;
15144
15748
  };
15749
+ frozenBy?: {
15750
+ type: "user" | "serviceAccount" | "system";
15751
+ id: string;
15752
+ };
15145
15753
  };
15146
15754
  };
15147
15755
  /**
@@ -15150,18 +15758,23 @@ export type GetArtifactStateErrors = {
15150
15758
  501: {
15151
15759
  error: string;
15152
15760
  /**
15153
- * 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.
15761
+ * 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.
15154
15762
  */
15155
15763
  code?: string;
15156
15764
  /**
15157
- * With artifact_moved: the latest version and who published it
15765
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15158
15766
  */
15159
15767
  latest?: {
15160
15768
  version: number;
15769
+ revision: number;
15161
15770
  author: {
15162
15771
  type: "user" | "serviceAccount" | "system";
15163
15772
  id: string;
15164
15773
  };
15774
+ frozenBy?: {
15775
+ type: "user" | "serviceAccount" | "system";
15776
+ id: string;
15777
+ };
15165
15778
  };
15166
15779
  };
15167
15780
  };
@@ -15204,18 +15817,23 @@ export type DeleteArtifactStateValueErrors = {
15204
15817
  400: {
15205
15818
  error: string;
15206
15819
  /**
15207
- * 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.
15820
+ * 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.
15208
15821
  */
15209
15822
  code?: string;
15210
15823
  /**
15211
- * With artifact_moved: the latest version and who published it
15824
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15212
15825
  */
15213
15826
  latest?: {
15214
15827
  version: number;
15828
+ revision: number;
15215
15829
  author: {
15216
15830
  type: "user" | "serviceAccount" | "system";
15217
15831
  id: string;
15218
15832
  };
15833
+ frozenBy?: {
15834
+ type: "user" | "serviceAccount" | "system";
15835
+ id: string;
15836
+ };
15219
15837
  };
15220
15838
  };
15221
15839
  /**
@@ -15224,18 +15842,23 @@ export type DeleteArtifactStateValueErrors = {
15224
15842
  403: {
15225
15843
  error: string;
15226
15844
  /**
15227
- * 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.
15845
+ * 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.
15228
15846
  */
15229
15847
  code?: string;
15230
15848
  /**
15231
- * With artifact_moved: the latest version and who published it
15849
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15232
15850
  */
15233
15851
  latest?: {
15234
15852
  version: number;
15853
+ revision: number;
15235
15854
  author: {
15236
15855
  type: "user" | "serviceAccount" | "system";
15237
15856
  id: string;
15238
15857
  };
15858
+ frozenBy?: {
15859
+ type: "user" | "serviceAccount" | "system";
15860
+ id: string;
15861
+ };
15239
15862
  };
15240
15863
  };
15241
15864
  /**
@@ -15244,18 +15867,23 @@ export type DeleteArtifactStateValueErrors = {
15244
15867
  404: {
15245
15868
  error: string;
15246
15869
  /**
15247
- * 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.
15870
+ * 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.
15248
15871
  */
15249
15872
  code?: string;
15250
15873
  /**
15251
- * With artifact_moved: the latest version and who published it
15874
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15252
15875
  */
15253
15876
  latest?: {
15254
15877
  version: number;
15878
+ revision: number;
15255
15879
  author: {
15256
15880
  type: "user" | "serviceAccount" | "system";
15257
15881
  id: string;
15258
15882
  };
15883
+ frozenBy?: {
15884
+ type: "user" | "serviceAccount" | "system";
15885
+ id: string;
15886
+ };
15259
15887
  };
15260
15888
  };
15261
15889
  /**
@@ -15264,18 +15892,23 @@ export type DeleteArtifactStateValueErrors = {
15264
15892
  501: {
15265
15893
  error: string;
15266
15894
  /**
15267
- * 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.
15895
+ * 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.
15268
15896
  */
15269
15897
  code?: string;
15270
15898
  /**
15271
- * With artifact_moved: the latest version and who published it
15899
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15272
15900
  */
15273
15901
  latest?: {
15274
15902
  version: number;
15903
+ revision: number;
15275
15904
  author: {
15276
15905
  type: "user" | "serviceAccount" | "system";
15277
15906
  id: string;
15278
15907
  };
15908
+ frozenBy?: {
15909
+ type: "user" | "serviceAccount" | "system";
15910
+ id: string;
15911
+ };
15279
15912
  };
15280
15913
  };
15281
15914
  };
@@ -15313,18 +15946,23 @@ export type SetArtifactStateErrors = {
15313
15946
  400: {
15314
15947
  error: string;
15315
15948
  /**
15316
- * 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.
15949
+ * 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.
15317
15950
  */
15318
15951
  code?: string;
15319
15952
  /**
15320
- * With artifact_moved: the latest version and who published it
15953
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15321
15954
  */
15322
15955
  latest?: {
15323
15956
  version: number;
15957
+ revision: number;
15324
15958
  author: {
15325
15959
  type: "user" | "serviceAccount" | "system";
15326
15960
  id: string;
15327
15961
  };
15962
+ frozenBy?: {
15963
+ type: "user" | "serviceAccount" | "system";
15964
+ id: string;
15965
+ };
15328
15966
  };
15329
15967
  };
15330
15968
  /**
@@ -15333,18 +15971,23 @@ export type SetArtifactStateErrors = {
15333
15971
  403: {
15334
15972
  error: string;
15335
15973
  /**
15336
- * 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.
15974
+ * 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.
15337
15975
  */
15338
15976
  code?: string;
15339
15977
  /**
15340
- * With artifact_moved: the latest version and who published it
15978
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15341
15979
  */
15342
15980
  latest?: {
15343
15981
  version: number;
15982
+ revision: number;
15344
15983
  author: {
15345
15984
  type: "user" | "serviceAccount" | "system";
15346
15985
  id: string;
15347
15986
  };
15987
+ frozenBy?: {
15988
+ type: "user" | "serviceAccount" | "system";
15989
+ id: string;
15990
+ };
15348
15991
  };
15349
15992
  };
15350
15993
  /**
@@ -15353,18 +15996,23 @@ export type SetArtifactStateErrors = {
15353
15996
  404: {
15354
15997
  error: string;
15355
15998
  /**
15356
- * 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.
15999
+ * 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.
15357
16000
  */
15358
16001
  code?: string;
15359
16002
  /**
15360
- * With artifact_moved: the latest version and who published it
16003
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15361
16004
  */
15362
16005
  latest?: {
15363
16006
  version: number;
16007
+ revision: number;
15364
16008
  author: {
15365
16009
  type: "user" | "serviceAccount" | "system";
15366
16010
  id: string;
15367
16011
  };
16012
+ frozenBy?: {
16013
+ type: "user" | "serviceAccount" | "system";
16014
+ id: string;
16015
+ };
15368
16016
  };
15369
16017
  };
15370
16018
  /**
@@ -15373,18 +16021,23 @@ export type SetArtifactStateErrors = {
15373
16021
  413: {
15374
16022
  error: string;
15375
16023
  /**
15376
- * 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.
16024
+ * 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.
15377
16025
  */
15378
16026
  code?: string;
15379
16027
  /**
15380
- * With artifact_moved: the latest version and who published it
16028
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15381
16029
  */
15382
16030
  latest?: {
15383
16031
  version: number;
16032
+ revision: number;
15384
16033
  author: {
15385
16034
  type: "user" | "serviceAccount" | "system";
15386
16035
  id: string;
15387
16036
  };
16037
+ frozenBy?: {
16038
+ type: "user" | "serviceAccount" | "system";
16039
+ id: string;
16040
+ };
15388
16041
  };
15389
16042
  };
15390
16043
  /**
@@ -15393,18 +16046,23 @@ export type SetArtifactStateErrors = {
15393
16046
  501: {
15394
16047
  error: string;
15395
16048
  /**
15396
- * 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.
16049
+ * 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.
15397
16050
  */
15398
16051
  code?: string;
15399
16052
  /**
15400
- * With artifact_moved: the latest version and who published it
16053
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15401
16054
  */
15402
16055
  latest?: {
15403
16056
  version: number;
16057
+ revision: number;
15404
16058
  author: {
15405
16059
  type: "user" | "serviceAccount" | "system";
15406
16060
  id: string;
15407
16061
  };
16062
+ frozenBy?: {
16063
+ type: "user" | "serviceAccount" | "system";
16064
+ id: string;
16065
+ };
15408
16066
  };
15409
16067
  };
15410
16068
  };
@@ -15423,7 +16081,7 @@ export type SetArtifactStateResponses = {
15423
16081
  };
15424
16082
  };
15425
16083
  export type SetArtifactStateResponse = SetArtifactStateResponses[keyof SetArtifactStateResponses];
15426
- export type PublishArtifactVersionData = {
16084
+ export type UpdateArtifactData = {
15427
16085
  body: {
15428
16086
  kind: "document" | "sheet" | "slides" | "page" | "canvas" | "file";
15429
16087
  title: string;
@@ -15445,35 +16103,1746 @@ export type PublishArtifactVersionData = {
15445
16103
  };
15446
16104
  }>;
15447
16105
  /**
15448
- * The version this one was made from. When another was published since, the publish is refused with 409 artifact_moved, naming the latest version.
16106
+ * 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.
15449
16107
  */
15450
- baseVersion?: number;
16108
+ baseRevision?: number;
15451
16109
  };
15452
16110
  path: {
15453
16111
  artifactId: string;
15454
16112
  };
15455
16113
  query?: never;
15456
- url: "/api/artifacts/{artifactId}/versions";
16114
+ url: "/api/artifacts/{artifactId}/content";
15457
16115
  };
15458
- export type PublishArtifactVersionErrors = {
16116
+ export type UpdateArtifactErrors = {
15459
16117
  /**
15460
16118
  * Response for status 400
15461
16119
  */
15462
16120
  400: {
15463
16121
  error: string;
15464
16122
  /**
15465
- * 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.
16123
+ * 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.
15466
16124
  */
15467
16125
  code?: string;
15468
16126
  /**
15469
- * With artifact_moved: the latest version and who published it
16127
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15470
16128
  */
15471
16129
  latest?: {
15472
16130
  version: number;
16131
+ revision: number;
15473
16132
  author: {
15474
16133
  type: "user" | "serviceAccount" | "system";
15475
16134
  id: string;
15476
16135
  };
16136
+ frozenBy?: {
16137
+ type: "user" | "serviceAccount" | "system";
16138
+ id: string;
16139
+ };
16140
+ };
16141
+ };
16142
+ /**
16143
+ * Response for status 403
16144
+ */
16145
+ 403: {
16146
+ error: string;
16147
+ /**
16148
+ * 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.
16149
+ */
16150
+ code?: string;
16151
+ /**
16152
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
16153
+ */
16154
+ latest?: {
16155
+ version: number;
16156
+ revision: number;
16157
+ author: {
16158
+ type: "user" | "serviceAccount" | "system";
16159
+ id: string;
16160
+ };
16161
+ frozenBy?: {
16162
+ type: "user" | "serviceAccount" | "system";
16163
+ id: string;
16164
+ };
16165
+ };
16166
+ };
16167
+ /**
16168
+ * Response for status 404
16169
+ */
16170
+ 404: {
16171
+ error: string;
16172
+ /**
16173
+ * 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.
16174
+ */
16175
+ code?: string;
16176
+ /**
16177
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
16178
+ */
16179
+ latest?: {
16180
+ version: number;
16181
+ revision: number;
16182
+ author: {
16183
+ type: "user" | "serviceAccount" | "system";
16184
+ id: string;
16185
+ };
16186
+ frozenBy?: {
16187
+ type: "user" | "serviceAccount" | "system";
16188
+ id: string;
16189
+ };
16190
+ };
16191
+ };
16192
+ /**
16193
+ * Response for status 409
16194
+ */
16195
+ 409: {
16196
+ error: string;
16197
+ /**
16198
+ * 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.
16199
+ */
16200
+ code?: string;
16201
+ /**
16202
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
16203
+ */
16204
+ latest?: {
16205
+ version: number;
16206
+ revision: number;
16207
+ author: {
16208
+ type: "user" | "serviceAccount" | "system";
16209
+ id: string;
16210
+ };
16211
+ frozenBy?: {
16212
+ type: "user" | "serviceAccount" | "system";
16213
+ id: string;
16214
+ };
16215
+ };
16216
+ };
16217
+ /**
16218
+ * Response for status 501
16219
+ */
16220
+ 501: {
16221
+ error: string;
16222
+ /**
16223
+ * 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.
16224
+ */
16225
+ code?: string;
16226
+ /**
16227
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
16228
+ */
16229
+ latest?: {
16230
+ version: number;
16231
+ revision: number;
16232
+ author: {
16233
+ type: "user" | "serviceAccount" | "system";
16234
+ id: string;
16235
+ };
16236
+ frozenBy?: {
16237
+ type: "user" | "serviceAccount" | "system";
16238
+ id: string;
16239
+ };
16240
+ };
16241
+ };
16242
+ };
16243
+ export type UpdateArtifactError = UpdateArtifactErrors[keyof UpdateArtifactErrors];
16244
+ export type UpdateArtifactResponses = {
16245
+ /**
16246
+ * Response for status 200
16247
+ */
16248
+ 200: {
16249
+ artifact: {
16250
+ id: string;
16251
+ projectId: string;
16252
+ kind: "document" | "sheet" | "slides" | "page" | "canvas" | "file";
16253
+ title: string;
16254
+ owner: {
16255
+ type: "user" | "serviceAccount" | "system";
16256
+ id: string;
16257
+ };
16258
+ latestVersion: number;
16259
+ /**
16260
+ * 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
16261
+ */
16262
+ revision: number;
16263
+ createdAt: string;
16264
+ /**
16265
+ * When the artifact last changed
16266
+ */
16267
+ updatedAt: string;
16268
+ };
16269
+ version: {
16270
+ artifactId: string;
16271
+ version: number;
16272
+ /**
16273
+ * The artifact's revision when this version last changed: the latest version's is the artifact's
16274
+ */
16275
+ revision: number;
16276
+ /**
16277
+ * Someone created this version: it never changes again. The latest version is open until then, and each write replaces its content
16278
+ */
16279
+ frozen: boolean;
16280
+ title: string;
16281
+ entry: string;
16282
+ files: Array<{
16283
+ /**
16284
+ * The file's path inside the artifact, such as figures/revenue.svg
16285
+ */
16286
+ path: string;
16287
+ file: {
16288
+ blobId: string;
16289
+ digest: string;
16290
+ sizeBytes: number;
16291
+ fileName?: string;
16292
+ mediaType?: string;
16293
+ logicalPath?: string;
16294
+ };
16295
+ }>;
16296
+ outline: {
16297
+ kind: "document";
16298
+ headings: Array<{
16299
+ depth: number;
16300
+ text: string;
16301
+ slug: string;
16302
+ }>;
16303
+ } | {
16304
+ kind: "sheet";
16305
+ sheets: Array<{
16306
+ name: string;
16307
+ /**
16308
+ * The rows of its CSV; none for a live sheet
16309
+ */
16310
+ rows: number;
16311
+ columns: Array<string>;
16312
+ /**
16313
+ * A live sheet's query, queries/<name>.json, whose rows each reader reads
16314
+ */
16315
+ query?: string;
16316
+ }>;
16317
+ charts: Array<string>;
16318
+ } | {
16319
+ kind: "slides";
16320
+ slides: Array<{
16321
+ title?: string;
16322
+ }>;
16323
+ } | {
16324
+ kind: "page";
16325
+ title?: string;
16326
+ } | {
16327
+ kind: "canvas";
16328
+ items: Array<{
16329
+ id: string;
16330
+ type: "board";
16331
+ title?: string;
16332
+ file: string;
16333
+ w: number;
16334
+ h: number;
16335
+ /**
16336
+ * What the board's preview is a picture of: a board kept as it was keeps it
16337
+ */
16338
+ renderKey?: string;
16339
+ } | {
16340
+ id: string;
16341
+ type: "section";
16342
+ title?: string;
16343
+ }>;
16344
+ /**
16345
+ * The modes each board has a preview in: both, or the one its theme.json pins
16346
+ */
16347
+ themes?: Array<"light" | "dark">;
16348
+ } | {
16349
+ kind: "file";
16350
+ mediaType: string;
16351
+ };
16352
+ references: Array<{
16353
+ address: string;
16354
+ as: "embed" | "link";
16355
+ at: string;
16356
+ resolvedVersion: number;
16357
+ }>;
16358
+ /**
16359
+ * Who last wrote its content
16360
+ */
16361
+ author: {
16362
+ type: "user" | "serviceAccount" | "system";
16363
+ id: string;
16364
+ };
16365
+ /**
16366
+ * The Agent turn and thread its content was last written from
16367
+ */
16368
+ origin?: {
16369
+ threadId: string;
16370
+ runId: string;
16371
+ };
16372
+ /**
16373
+ * When the version was opened
16374
+ */
16375
+ createdAt: string;
16376
+ /**
16377
+ * When its content was last written
16378
+ */
16379
+ updatedAt: string;
16380
+ /**
16381
+ * When it was created, which froze it
16382
+ */
16383
+ frozenAt?: string;
16384
+ /**
16385
+ * Who created it
16386
+ */
16387
+ frozenBy?: {
16388
+ type: "user" | "serviceAccount" | "system";
16389
+ id: string;
16390
+ };
16391
+ /**
16392
+ * 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
16393
+ */
16394
+ boardPreviews?: {
16395
+ [key: string]: "ready" | "pending" | "none";
16396
+ };
16397
+ };
16398
+ warnings: Array<{
16399
+ code: string;
16400
+ message: string;
16401
+ part?: string;
16402
+ }>;
16403
+ };
16404
+ };
16405
+ export type UpdateArtifactResponse = UpdateArtifactResponses[keyof UpdateArtifactResponses];
16406
+ export type FreezeArtifactVersionData = {
16407
+ body: {
16408
+ /**
16409
+ * 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.
16410
+ */
16411
+ baseRevision?: number;
16412
+ };
16413
+ path: {
16414
+ artifactId: string;
16415
+ };
16416
+ query?: never;
16417
+ url: "/api/artifacts/{artifactId}/freeze";
16418
+ };
16419
+ export type FreezeArtifactVersionErrors = {
16420
+ /**
16421
+ * Response for status 400
16422
+ */
16423
+ 400: {
16424
+ error: string;
16425
+ /**
16426
+ * 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.
16427
+ */
16428
+ code?: string;
16429
+ /**
16430
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
16431
+ */
16432
+ latest?: {
16433
+ version: number;
16434
+ revision: number;
16435
+ author: {
16436
+ type: "user" | "serviceAccount" | "system";
16437
+ id: string;
16438
+ };
16439
+ frozenBy?: {
16440
+ type: "user" | "serviceAccount" | "system";
16441
+ id: string;
16442
+ };
16443
+ };
16444
+ };
16445
+ /**
16446
+ * Response for status 403
16447
+ */
16448
+ 403: {
16449
+ error: string;
16450
+ /**
16451
+ * 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.
16452
+ */
16453
+ code?: string;
16454
+ /**
16455
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
16456
+ */
16457
+ latest?: {
16458
+ version: number;
16459
+ revision: number;
16460
+ author: {
16461
+ type: "user" | "serviceAccount" | "system";
16462
+ id: string;
16463
+ };
16464
+ frozenBy?: {
16465
+ type: "user" | "serviceAccount" | "system";
16466
+ id: string;
16467
+ };
16468
+ };
16469
+ };
16470
+ /**
16471
+ * Response for status 404
16472
+ */
16473
+ 404: {
16474
+ error: string;
16475
+ /**
16476
+ * 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.
16477
+ */
16478
+ code?: string;
16479
+ /**
16480
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
16481
+ */
16482
+ latest?: {
16483
+ version: number;
16484
+ revision: number;
16485
+ author: {
16486
+ type: "user" | "serviceAccount" | "system";
16487
+ id: string;
16488
+ };
16489
+ frozenBy?: {
16490
+ type: "user" | "serviceAccount" | "system";
16491
+ id: string;
16492
+ };
16493
+ };
16494
+ };
16495
+ /**
16496
+ * Response for status 409
16497
+ */
16498
+ 409: {
16499
+ error: string;
16500
+ /**
16501
+ * 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.
16502
+ */
16503
+ code?: string;
16504
+ /**
16505
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
16506
+ */
16507
+ latest?: {
16508
+ version: number;
16509
+ revision: number;
16510
+ author: {
16511
+ type: "user" | "serviceAccount" | "system";
16512
+ id: string;
16513
+ };
16514
+ frozenBy?: {
16515
+ type: "user" | "serviceAccount" | "system";
16516
+ id: string;
16517
+ };
16518
+ };
16519
+ };
16520
+ /**
16521
+ * Response for status 501
16522
+ */
16523
+ 501: {
16524
+ error: string;
16525
+ /**
16526
+ * 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.
16527
+ */
16528
+ code?: string;
16529
+ /**
16530
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
16531
+ */
16532
+ latest?: {
16533
+ version: number;
16534
+ revision: number;
16535
+ author: {
16536
+ type: "user" | "serviceAccount" | "system";
16537
+ id: string;
16538
+ };
16539
+ frozenBy?: {
16540
+ type: "user" | "serviceAccount" | "system";
16541
+ id: string;
16542
+ };
16543
+ };
16544
+ };
16545
+ };
16546
+ export type FreezeArtifactVersionError = FreezeArtifactVersionErrors[keyof FreezeArtifactVersionErrors];
16547
+ export type FreezeArtifactVersionResponses = {
16548
+ /**
16549
+ * Response for status 200
16550
+ */
16551
+ 200: {
16552
+ artifact: {
16553
+ id: string;
16554
+ projectId: string;
16555
+ kind: "document" | "sheet" | "slides" | "page" | "canvas" | "file";
16556
+ title: string;
16557
+ owner: {
16558
+ type: "user" | "serviceAccount" | "system";
16559
+ id: string;
16560
+ };
16561
+ latestVersion: number;
16562
+ /**
16563
+ * 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
16564
+ */
16565
+ revision: number;
16566
+ createdAt: string;
16567
+ /**
16568
+ * When the artifact last changed
16569
+ */
16570
+ updatedAt: string;
16571
+ };
16572
+ version: {
16573
+ artifactId: string;
16574
+ version: number;
16575
+ /**
16576
+ * The artifact's revision when this version last changed: the latest version's is the artifact's
16577
+ */
16578
+ revision: number;
16579
+ /**
16580
+ * Someone created this version: it never changes again. The latest version is open until then, and each write replaces its content
16581
+ */
16582
+ frozen: boolean;
16583
+ title: string;
16584
+ entry: string;
16585
+ files: Array<{
16586
+ /**
16587
+ * The file's path inside the artifact, such as figures/revenue.svg
16588
+ */
16589
+ path: string;
16590
+ file: {
16591
+ blobId: string;
16592
+ digest: string;
16593
+ sizeBytes: number;
16594
+ fileName?: string;
16595
+ mediaType?: string;
16596
+ logicalPath?: string;
16597
+ };
16598
+ }>;
16599
+ outline: {
16600
+ kind: "document";
16601
+ headings: Array<{
16602
+ depth: number;
16603
+ text: string;
16604
+ slug: string;
16605
+ }>;
16606
+ } | {
16607
+ kind: "sheet";
16608
+ sheets: Array<{
16609
+ name: string;
16610
+ /**
16611
+ * The rows of its CSV; none for a live sheet
16612
+ */
16613
+ rows: number;
16614
+ columns: Array<string>;
16615
+ /**
16616
+ * A live sheet's query, queries/<name>.json, whose rows each reader reads
16617
+ */
16618
+ query?: string;
16619
+ }>;
16620
+ charts: Array<string>;
16621
+ } | {
16622
+ kind: "slides";
16623
+ slides: Array<{
16624
+ title?: string;
16625
+ }>;
16626
+ } | {
16627
+ kind: "page";
16628
+ title?: string;
16629
+ } | {
16630
+ kind: "canvas";
16631
+ items: Array<{
16632
+ id: string;
16633
+ type: "board";
16634
+ title?: string;
16635
+ file: string;
16636
+ w: number;
16637
+ h: number;
16638
+ /**
16639
+ * What the board's preview is a picture of: a board kept as it was keeps it
16640
+ */
16641
+ renderKey?: string;
16642
+ } | {
16643
+ id: string;
16644
+ type: "section";
16645
+ title?: string;
16646
+ }>;
16647
+ /**
16648
+ * The modes each board has a preview in: both, or the one its theme.json pins
16649
+ */
16650
+ themes?: Array<"light" | "dark">;
16651
+ } | {
16652
+ kind: "file";
16653
+ mediaType: string;
16654
+ };
16655
+ references: Array<{
16656
+ address: string;
16657
+ as: "embed" | "link";
16658
+ at: string;
16659
+ resolvedVersion: number;
16660
+ }>;
16661
+ /**
16662
+ * Who last wrote its content
16663
+ */
16664
+ author: {
16665
+ type: "user" | "serviceAccount" | "system";
16666
+ id: string;
16667
+ };
16668
+ /**
16669
+ * The Agent turn and thread its content was last written from
16670
+ */
16671
+ origin?: {
16672
+ threadId: string;
16673
+ runId: string;
16674
+ };
16675
+ /**
16676
+ * When the version was opened
16677
+ */
16678
+ createdAt: string;
16679
+ /**
16680
+ * When its content was last written
16681
+ */
16682
+ updatedAt: string;
16683
+ /**
16684
+ * When it was created, which froze it
16685
+ */
16686
+ frozenAt?: string;
16687
+ /**
16688
+ * Who created it
16689
+ */
16690
+ frozenBy?: {
16691
+ type: "user" | "serviceAccount" | "system";
16692
+ id: string;
16693
+ };
16694
+ /**
16695
+ * 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
16696
+ */
16697
+ boardPreviews?: {
16698
+ [key: string]: "ready" | "pending" | "none";
16699
+ };
16700
+ };
16701
+ };
16702
+ };
16703
+ export type FreezeArtifactVersionResponse = FreezeArtifactVersionResponses[keyof FreezeArtifactVersionResponses];
16704
+ export type ListArtifactCommentsData = {
16705
+ body?: never;
16706
+ path: {
16707
+ artifactId: string;
16708
+ };
16709
+ query?: never;
16710
+ url: "/api/artifacts/{artifactId}/comments";
16711
+ };
16712
+ export type ListArtifactCommentsErrors = {
16713
+ /**
16714
+ * Response for status 403
16715
+ */
16716
+ 403: {
16717
+ error: string;
16718
+ /**
16719
+ * 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.
16720
+ */
16721
+ code?: string;
16722
+ /**
16723
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
16724
+ */
16725
+ latest?: {
16726
+ version: number;
16727
+ revision: number;
16728
+ author: {
16729
+ type: "user" | "serviceAccount" | "system";
16730
+ id: string;
16731
+ };
16732
+ frozenBy?: {
16733
+ type: "user" | "serviceAccount" | "system";
16734
+ id: string;
16735
+ };
16736
+ };
16737
+ };
16738
+ /**
16739
+ * Response for status 404
16740
+ */
16741
+ 404: {
16742
+ error: string;
16743
+ /**
16744
+ * 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.
16745
+ */
16746
+ code?: string;
16747
+ /**
16748
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
16749
+ */
16750
+ latest?: {
16751
+ version: number;
16752
+ revision: number;
16753
+ author: {
16754
+ type: "user" | "serviceAccount" | "system";
16755
+ id: string;
16756
+ };
16757
+ frozenBy?: {
16758
+ type: "user" | "serviceAccount" | "system";
16759
+ id: string;
16760
+ };
16761
+ };
16762
+ };
16763
+ /**
16764
+ * Response for status 501
16765
+ */
16766
+ 501: {
16767
+ error: string;
16768
+ /**
16769
+ * 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.
16770
+ */
16771
+ code?: string;
16772
+ /**
16773
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
16774
+ */
16775
+ latest?: {
16776
+ version: number;
16777
+ revision: number;
16778
+ author: {
16779
+ type: "user" | "serviceAccount" | "system";
16780
+ id: string;
16781
+ };
16782
+ frozenBy?: {
16783
+ type: "user" | "serviceAccount" | "system";
16784
+ id: string;
16785
+ };
16786
+ };
16787
+ };
16788
+ };
16789
+ export type ListArtifactCommentsError = ListArtifactCommentsErrors[keyof ListArtifactCommentsErrors];
16790
+ export type ListArtifactCommentsResponses = {
16791
+ /**
16792
+ * Response for status 200
16793
+ */
16794
+ 200: {
16795
+ /**
16796
+ * Comments and replies, oldest first
16797
+ */
16798
+ comments: Array<{
16799
+ artifactId: string;
16800
+ id: string;
16801
+ /**
16802
+ * The comment it replies to, for a reply
16803
+ */
16804
+ parentId?: string;
16805
+ anchor: {
16806
+ /**
16807
+ * The id of the canvas's board it is about
16808
+ */
16809
+ board?: string;
16810
+ /**
16811
+ * The address of the board's element it is about, such as body>main:0>h1:0
16812
+ */
16813
+ element?: string;
16814
+ /**
16815
+ * The element's first words, which name it once it is gone; kept to 120 characters
16816
+ */
16817
+ label?: string;
16818
+ /**
16819
+ * Where on the board its pin is, as fractions of the board's width and height from its top left
16820
+ */
16821
+ point?: {
16822
+ x: number;
16823
+ y: number;
16824
+ };
16825
+ /**
16826
+ * The artifact's revision its author saw
16827
+ */
16828
+ revision: number;
16829
+ };
16830
+ /**
16831
+ * Plain text
16832
+ */
16833
+ body: string;
16834
+ /**
16835
+ * Who wrote it: a principal, or a guest, someone without an account who opened a shared link, whose id is their link's session
16836
+ */
16837
+ author: {
16838
+ type: "user" | "serviceAccount" | "system" | "guest";
16839
+ id: string;
16840
+ };
16841
+ /**
16842
+ * 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
16843
+ */
16844
+ authorName: string | null;
16845
+ /**
16846
+ * The Agent's run that wrote it for its author, and that run's conversation
16847
+ */
16848
+ origin?: {
16849
+ threadId: string;
16850
+ runId: string;
16851
+ };
16852
+ createdAt: string;
16853
+ /**
16854
+ * When someone marked it resolved
16855
+ */
16856
+ resolvedAt?: string;
16857
+ /**
16858
+ * Who marked it resolved
16859
+ */
16860
+ resolvedBy?: {
16861
+ type: "user" | "serviceAccount" | "system";
16862
+ id: string;
16863
+ };
16864
+ }>;
16865
+ };
16866
+ };
16867
+ export type ListArtifactCommentsResponse = ListArtifactCommentsResponses[keyof ListArtifactCommentsResponses];
16868
+ export type AddArtifactCommentData = {
16869
+ body: {
16870
+ /**
16871
+ * Plain text
16872
+ */
16873
+ body: string;
16874
+ /**
16875
+ * 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.
16876
+ */
16877
+ anchor?: {
16878
+ /**
16879
+ * The id of the canvas's board it is about
16880
+ */
16881
+ board?: string;
16882
+ /**
16883
+ * The address of the board's element it is about, such as body>main:0>h1:0
16884
+ */
16885
+ element?: string;
16886
+ /**
16887
+ * The element's first words, which name it once it is gone; kept to 120 characters
16888
+ */
16889
+ label?: string;
16890
+ /**
16891
+ * Where on the board its pin is, as fractions of the board's width and height from its top left
16892
+ */
16893
+ point?: {
16894
+ x: number;
16895
+ y: number;
16896
+ };
16897
+ /**
16898
+ * The artifact's revision its author saw
16899
+ */
16900
+ revision?: number;
16901
+ };
16902
+ /**
16903
+ * The comment it replies to
16904
+ */
16905
+ parentId?: string;
16906
+ };
16907
+ path: {
16908
+ artifactId: string;
16909
+ };
16910
+ query?: never;
16911
+ url: "/api/artifacts/{artifactId}/comments";
16912
+ };
16913
+ export type AddArtifactCommentErrors = {
16914
+ /**
16915
+ * Response for status 400
16916
+ */
16917
+ 400: {
16918
+ error: string;
16919
+ /**
16920
+ * 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.
16921
+ */
16922
+ code?: string;
16923
+ /**
16924
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
16925
+ */
16926
+ latest?: {
16927
+ version: number;
16928
+ revision: number;
16929
+ author: {
16930
+ type: "user" | "serviceAccount" | "system";
16931
+ id: string;
16932
+ };
16933
+ frozenBy?: {
16934
+ type: "user" | "serviceAccount" | "system";
16935
+ id: string;
16936
+ };
16937
+ };
16938
+ };
16939
+ /**
16940
+ * Response for status 403
16941
+ */
16942
+ 403: {
16943
+ error: string;
16944
+ /**
16945
+ * 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.
16946
+ */
16947
+ code?: string;
16948
+ /**
16949
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
16950
+ */
16951
+ latest?: {
16952
+ version: number;
16953
+ revision: number;
16954
+ author: {
16955
+ type: "user" | "serviceAccount" | "system";
16956
+ id: string;
16957
+ };
16958
+ frozenBy?: {
16959
+ type: "user" | "serviceAccount" | "system";
16960
+ id: string;
16961
+ };
16962
+ };
16963
+ };
16964
+ /**
16965
+ * Response for status 404
16966
+ */
16967
+ 404: {
16968
+ error: string;
16969
+ /**
16970
+ * 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.
16971
+ */
16972
+ code?: string;
16973
+ /**
16974
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
16975
+ */
16976
+ latest?: {
16977
+ version: number;
16978
+ revision: number;
16979
+ author: {
16980
+ type: "user" | "serviceAccount" | "system";
16981
+ id: string;
16982
+ };
16983
+ frozenBy?: {
16984
+ type: "user" | "serviceAccount" | "system";
16985
+ id: string;
16986
+ };
16987
+ };
16988
+ };
16989
+ /**
16990
+ * Response for status 413
16991
+ */
16992
+ 413: {
16993
+ error: string;
16994
+ /**
16995
+ * 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.
16996
+ */
16997
+ code?: string;
16998
+ /**
16999
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17000
+ */
17001
+ latest?: {
17002
+ version: number;
17003
+ revision: number;
17004
+ author: {
17005
+ type: "user" | "serviceAccount" | "system";
17006
+ id: string;
17007
+ };
17008
+ frozenBy?: {
17009
+ type: "user" | "serviceAccount" | "system";
17010
+ id: string;
17011
+ };
17012
+ };
17013
+ };
17014
+ /**
17015
+ * Response for status 501
17016
+ */
17017
+ 501: {
17018
+ error: string;
17019
+ /**
17020
+ * 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.
17021
+ */
17022
+ code?: string;
17023
+ /**
17024
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17025
+ */
17026
+ latest?: {
17027
+ version: number;
17028
+ revision: number;
17029
+ author: {
17030
+ type: "user" | "serviceAccount" | "system";
17031
+ id: string;
17032
+ };
17033
+ frozenBy?: {
17034
+ type: "user" | "serviceAccount" | "system";
17035
+ id: string;
17036
+ };
17037
+ };
17038
+ };
17039
+ };
17040
+ export type AddArtifactCommentError = AddArtifactCommentErrors[keyof AddArtifactCommentErrors];
17041
+ export type AddArtifactCommentResponses = {
17042
+ /**
17043
+ * Response for status 201
17044
+ */
17045
+ 201: {
17046
+ artifactId: string;
17047
+ id: string;
17048
+ /**
17049
+ * The comment it replies to, for a reply
17050
+ */
17051
+ parentId?: string;
17052
+ anchor: {
17053
+ /**
17054
+ * The id of the canvas's board it is about
17055
+ */
17056
+ board?: string;
17057
+ /**
17058
+ * The address of the board's element it is about, such as body>main:0>h1:0
17059
+ */
17060
+ element?: string;
17061
+ /**
17062
+ * The element's first words, which name it once it is gone; kept to 120 characters
17063
+ */
17064
+ label?: string;
17065
+ /**
17066
+ * Where on the board its pin is, as fractions of the board's width and height from its top left
17067
+ */
17068
+ point?: {
17069
+ x: number;
17070
+ y: number;
17071
+ };
17072
+ /**
17073
+ * The artifact's revision its author saw
17074
+ */
17075
+ revision: number;
17076
+ };
17077
+ /**
17078
+ * Plain text
17079
+ */
17080
+ body: string;
17081
+ /**
17082
+ * Who wrote it: a principal, or a guest, someone without an account who opened a shared link, whose id is their link's session
17083
+ */
17084
+ author: {
17085
+ type: "user" | "serviceAccount" | "system" | "guest";
17086
+ id: string;
17087
+ };
17088
+ /**
17089
+ * 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
17090
+ */
17091
+ authorName: string | null;
17092
+ /**
17093
+ * The Agent's run that wrote it for its author, and that run's conversation
17094
+ */
17095
+ origin?: {
17096
+ threadId: string;
17097
+ runId: string;
17098
+ };
17099
+ createdAt: string;
17100
+ /**
17101
+ * When someone marked it resolved
17102
+ */
17103
+ resolvedAt?: string;
17104
+ /**
17105
+ * Who marked it resolved
17106
+ */
17107
+ resolvedBy?: {
17108
+ type: "user" | "serviceAccount" | "system";
17109
+ id: string;
17110
+ };
17111
+ };
17112
+ };
17113
+ export type AddArtifactCommentResponse = AddArtifactCommentResponses[keyof AddArtifactCommentResponses];
17114
+ export type ResolveArtifactCommentData = {
17115
+ body: {
17116
+ /**
17117
+ * False opens it again
17118
+ */
17119
+ resolved?: boolean;
17120
+ };
17121
+ path: {
17122
+ artifactId: string;
17123
+ commentId: string;
17124
+ };
17125
+ query?: never;
17126
+ url: "/api/artifacts/{artifactId}/comments/{commentId}/resolve";
17127
+ };
17128
+ export type ResolveArtifactCommentErrors = {
17129
+ /**
17130
+ * Response for status 400
17131
+ */
17132
+ 400: {
17133
+ error: string;
17134
+ /**
17135
+ * 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.
17136
+ */
17137
+ code?: string;
17138
+ /**
17139
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17140
+ */
17141
+ latest?: {
17142
+ version: number;
17143
+ revision: number;
17144
+ author: {
17145
+ type: "user" | "serviceAccount" | "system";
17146
+ id: string;
17147
+ };
17148
+ frozenBy?: {
17149
+ type: "user" | "serviceAccount" | "system";
17150
+ id: string;
17151
+ };
17152
+ };
17153
+ };
17154
+ /**
17155
+ * Response for status 403
17156
+ */
17157
+ 403: {
17158
+ error: string;
17159
+ /**
17160
+ * 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.
17161
+ */
17162
+ code?: string;
17163
+ /**
17164
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17165
+ */
17166
+ latest?: {
17167
+ version: number;
17168
+ revision: number;
17169
+ author: {
17170
+ type: "user" | "serviceAccount" | "system";
17171
+ id: string;
17172
+ };
17173
+ frozenBy?: {
17174
+ type: "user" | "serviceAccount" | "system";
17175
+ id: string;
17176
+ };
17177
+ };
17178
+ };
17179
+ /**
17180
+ * Response for status 404
17181
+ */
17182
+ 404: {
17183
+ error: string;
17184
+ /**
17185
+ * 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.
17186
+ */
17187
+ code?: string;
17188
+ /**
17189
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17190
+ */
17191
+ latest?: {
17192
+ version: number;
17193
+ revision: number;
17194
+ author: {
17195
+ type: "user" | "serviceAccount" | "system";
17196
+ id: string;
17197
+ };
17198
+ frozenBy?: {
17199
+ type: "user" | "serviceAccount" | "system";
17200
+ id: string;
17201
+ };
17202
+ };
17203
+ };
17204
+ /**
17205
+ * Response for status 501
17206
+ */
17207
+ 501: {
17208
+ error: string;
17209
+ /**
17210
+ * 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.
17211
+ */
17212
+ code?: string;
17213
+ /**
17214
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17215
+ */
17216
+ latest?: {
17217
+ version: number;
17218
+ revision: number;
17219
+ author: {
17220
+ type: "user" | "serviceAccount" | "system";
17221
+ id: string;
17222
+ };
17223
+ frozenBy?: {
17224
+ type: "user" | "serviceAccount" | "system";
17225
+ id: string;
17226
+ };
17227
+ };
17228
+ };
17229
+ };
17230
+ export type ResolveArtifactCommentError = ResolveArtifactCommentErrors[keyof ResolveArtifactCommentErrors];
17231
+ export type ResolveArtifactCommentResponses = {
17232
+ /**
17233
+ * Response for status 200
17234
+ */
17235
+ 200: {
17236
+ artifactId: string;
17237
+ id: string;
17238
+ /**
17239
+ * The comment it replies to, for a reply
17240
+ */
17241
+ parentId?: string;
17242
+ anchor: {
17243
+ /**
17244
+ * The id of the canvas's board it is about
17245
+ */
17246
+ board?: string;
17247
+ /**
17248
+ * The address of the board's element it is about, such as body>main:0>h1:0
17249
+ */
17250
+ element?: string;
17251
+ /**
17252
+ * The element's first words, which name it once it is gone; kept to 120 characters
17253
+ */
17254
+ label?: string;
17255
+ /**
17256
+ * Where on the board its pin is, as fractions of the board's width and height from its top left
17257
+ */
17258
+ point?: {
17259
+ x: number;
17260
+ y: number;
17261
+ };
17262
+ /**
17263
+ * The artifact's revision its author saw
17264
+ */
17265
+ revision: number;
17266
+ };
17267
+ /**
17268
+ * Plain text
17269
+ */
17270
+ body: string;
17271
+ /**
17272
+ * Who wrote it: a principal, or a guest, someone without an account who opened a shared link, whose id is their link's session
17273
+ */
17274
+ author: {
17275
+ type: "user" | "serviceAccount" | "system" | "guest";
17276
+ id: string;
17277
+ };
17278
+ /**
17279
+ * 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
17280
+ */
17281
+ authorName: string | null;
17282
+ /**
17283
+ * The Agent's run that wrote it for its author, and that run's conversation
17284
+ */
17285
+ origin?: {
17286
+ threadId: string;
17287
+ runId: string;
17288
+ };
17289
+ createdAt: string;
17290
+ /**
17291
+ * When someone marked it resolved
17292
+ */
17293
+ resolvedAt?: string;
17294
+ /**
17295
+ * Who marked it resolved
17296
+ */
17297
+ resolvedBy?: {
17298
+ type: "user" | "serviceAccount" | "system";
17299
+ id: string;
17300
+ };
17301
+ };
17302
+ };
17303
+ export type ResolveArtifactCommentResponse = ResolveArtifactCommentResponses[keyof ResolveArtifactCommentResponses];
17304
+ export type DeleteArtifactCommentData = {
17305
+ body?: never;
17306
+ path: {
17307
+ artifactId: string;
17308
+ commentId: string;
17309
+ };
17310
+ query?: never;
17311
+ url: "/api/artifacts/{artifactId}/comments/{commentId}";
17312
+ };
17313
+ export type DeleteArtifactCommentErrors = {
17314
+ /**
17315
+ * Response for status 403
17316
+ */
17317
+ 403: {
17318
+ error: string;
17319
+ /**
17320
+ * 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.
17321
+ */
17322
+ code?: string;
17323
+ /**
17324
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17325
+ */
17326
+ latest?: {
17327
+ version: number;
17328
+ revision: number;
17329
+ author: {
17330
+ type: "user" | "serviceAccount" | "system";
17331
+ id: string;
17332
+ };
17333
+ frozenBy?: {
17334
+ type: "user" | "serviceAccount" | "system";
17335
+ id: string;
17336
+ };
17337
+ };
17338
+ };
17339
+ /**
17340
+ * Response for status 404
17341
+ */
17342
+ 404: {
17343
+ error: string;
17344
+ /**
17345
+ * 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.
17346
+ */
17347
+ code?: string;
17348
+ /**
17349
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17350
+ */
17351
+ latest?: {
17352
+ version: number;
17353
+ revision: number;
17354
+ author: {
17355
+ type: "user" | "serviceAccount" | "system";
17356
+ id: string;
17357
+ };
17358
+ frozenBy?: {
17359
+ type: "user" | "serviceAccount" | "system";
17360
+ id: string;
17361
+ };
17362
+ };
17363
+ };
17364
+ /**
17365
+ * Response for status 501
17366
+ */
17367
+ 501: {
17368
+ error: string;
17369
+ /**
17370
+ * 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.
17371
+ */
17372
+ code?: string;
17373
+ /**
17374
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17375
+ */
17376
+ latest?: {
17377
+ version: number;
17378
+ revision: number;
17379
+ author: {
17380
+ type: "user" | "serviceAccount" | "system";
17381
+ id: string;
17382
+ };
17383
+ frozenBy?: {
17384
+ type: "user" | "serviceAccount" | "system";
17385
+ id: string;
17386
+ };
17387
+ };
17388
+ };
17389
+ };
17390
+ export type DeleteArtifactCommentError = DeleteArtifactCommentErrors[keyof DeleteArtifactCommentErrors];
17391
+ export type DeleteArtifactCommentResponses = {
17392
+ /**
17393
+ * Response for status 200
17394
+ */
17395
+ 200: {
17396
+ deleted: true;
17397
+ };
17398
+ };
17399
+ export type DeleteArtifactCommentResponse = DeleteArtifactCommentResponses[keyof DeleteArtifactCommentResponses];
17400
+ export type ListArtifactRestorePointsData = {
17401
+ body?: never;
17402
+ path: {
17403
+ artifactId: string;
17404
+ };
17405
+ query?: never;
17406
+ url: "/api/artifacts/{artifactId}/restore-points";
17407
+ };
17408
+ export type ListArtifactRestorePointsErrors = {
17409
+ /**
17410
+ * Response for status 403
17411
+ */
17412
+ 403: {
17413
+ error: string;
17414
+ /**
17415
+ * 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.
17416
+ */
17417
+ code?: string;
17418
+ /**
17419
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17420
+ */
17421
+ latest?: {
17422
+ version: number;
17423
+ revision: number;
17424
+ author: {
17425
+ type: "user" | "serviceAccount" | "system";
17426
+ id: string;
17427
+ };
17428
+ frozenBy?: {
17429
+ type: "user" | "serviceAccount" | "system";
17430
+ id: string;
17431
+ };
17432
+ };
17433
+ };
17434
+ /**
17435
+ * Response for status 404
17436
+ */
17437
+ 404: {
17438
+ error: string;
17439
+ /**
17440
+ * 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.
17441
+ */
17442
+ code?: string;
17443
+ /**
17444
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17445
+ */
17446
+ latest?: {
17447
+ version: number;
17448
+ revision: number;
17449
+ author: {
17450
+ type: "user" | "serviceAccount" | "system";
17451
+ id: string;
17452
+ };
17453
+ frozenBy?: {
17454
+ type: "user" | "serviceAccount" | "system";
17455
+ id: string;
17456
+ };
17457
+ };
17458
+ };
17459
+ /**
17460
+ * Response for status 501
17461
+ */
17462
+ 501: {
17463
+ error: string;
17464
+ /**
17465
+ * 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.
17466
+ */
17467
+ code?: string;
17468
+ /**
17469
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17470
+ */
17471
+ latest?: {
17472
+ version: number;
17473
+ revision: number;
17474
+ author: {
17475
+ type: "user" | "serviceAccount" | "system";
17476
+ id: string;
17477
+ };
17478
+ frozenBy?: {
17479
+ type: "user" | "serviceAccount" | "system";
17480
+ id: string;
17481
+ };
17482
+ };
17483
+ };
17484
+ };
17485
+ export type ListArtifactRestorePointsError = ListArtifactRestorePointsErrors[keyof ListArtifactRestorePointsErrors];
17486
+ export type ListArtifactRestorePointsResponses = {
17487
+ /**
17488
+ * Response for status 200
17489
+ */
17490
+ 200: {
17491
+ /**
17492
+ * Newest first: an artifact keeps its last 20
17493
+ */
17494
+ restorePoints: Array<{
17495
+ artifactId: string;
17496
+ /**
17497
+ * The revision whose content it holds, which restores it
17498
+ */
17499
+ revision: number;
17500
+ /**
17501
+ * The version it was taken of
17502
+ */
17503
+ version: number;
17504
+ /**
17505
+ * Whether that version was already created, and so frozen, when the point was taken: its content is then that version's
17506
+ */
17507
+ frozen: boolean;
17508
+ title: string;
17509
+ /**
17510
+ * Who had last written that content
17511
+ */
17512
+ author: {
17513
+ type: "user" | "serviceAccount" | "system";
17514
+ id: string;
17515
+ };
17516
+ origin?: {
17517
+ threadId: string;
17518
+ runId: string;
17519
+ };
17520
+ /**
17521
+ * When that content was written
17522
+ */
17523
+ updatedAt: string;
17524
+ /**
17525
+ * Taken before an Agent turn's first write to the artifact, or before a restore
17526
+ */
17527
+ reason: "turn" | "restore";
17528
+ /**
17529
+ * With turn: the turn's run
17530
+ */
17531
+ turnRunId?: string;
17532
+ /**
17533
+ * When it was taken
17534
+ */
17535
+ createdAt: string;
17536
+ }>;
17537
+ };
17538
+ };
17539
+ export type ListArtifactRestorePointsResponse = ListArtifactRestorePointsResponses[keyof ListArtifactRestorePointsResponses];
17540
+ export type GetArtifactRestorePointData = {
17541
+ body?: never;
17542
+ path: {
17543
+ artifactId: string;
17544
+ /**
17545
+ * The revision whose content the restore point holds
17546
+ */
17547
+ revision: string;
17548
+ };
17549
+ query?: never;
17550
+ url: "/api/artifacts/{artifactId}/restore-points/{revision}";
17551
+ };
17552
+ export type GetArtifactRestorePointErrors = {
17553
+ /**
17554
+ * Response for status 403
17555
+ */
17556
+ 403: {
17557
+ error: string;
17558
+ /**
17559
+ * 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.
17560
+ */
17561
+ code?: string;
17562
+ /**
17563
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17564
+ */
17565
+ latest?: {
17566
+ version: number;
17567
+ revision: number;
17568
+ author: {
17569
+ type: "user" | "serviceAccount" | "system";
17570
+ id: string;
17571
+ };
17572
+ frozenBy?: {
17573
+ type: "user" | "serviceAccount" | "system";
17574
+ id: string;
17575
+ };
17576
+ };
17577
+ };
17578
+ /**
17579
+ * Response for status 404
17580
+ */
17581
+ 404: {
17582
+ error: string;
17583
+ /**
17584
+ * 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.
17585
+ */
17586
+ code?: string;
17587
+ /**
17588
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17589
+ */
17590
+ latest?: {
17591
+ version: number;
17592
+ revision: number;
17593
+ author: {
17594
+ type: "user" | "serviceAccount" | "system";
17595
+ id: string;
17596
+ };
17597
+ frozenBy?: {
17598
+ type: "user" | "serviceAccount" | "system";
17599
+ id: string;
17600
+ };
17601
+ };
17602
+ };
17603
+ /**
17604
+ * Response for status 501
17605
+ */
17606
+ 501: {
17607
+ error: string;
17608
+ /**
17609
+ * 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.
17610
+ */
17611
+ code?: string;
17612
+ /**
17613
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17614
+ */
17615
+ latest?: {
17616
+ version: number;
17617
+ revision: number;
17618
+ author: {
17619
+ type: "user" | "serviceAccount" | "system";
17620
+ id: string;
17621
+ };
17622
+ frozenBy?: {
17623
+ type: "user" | "serviceAccount" | "system";
17624
+ id: string;
17625
+ };
17626
+ };
17627
+ };
17628
+ };
17629
+ export type GetArtifactRestorePointError = GetArtifactRestorePointErrors[keyof GetArtifactRestorePointErrors];
17630
+ export type GetArtifactRestorePointResponses = {
17631
+ /**
17632
+ * Response for status 200
17633
+ */
17634
+ 200: {
17635
+ artifactId: string;
17636
+ /**
17637
+ * The revision whose content it holds, which restores it
17638
+ */
17639
+ revision: number;
17640
+ /**
17641
+ * The version it was taken of
17642
+ */
17643
+ version: number;
17644
+ /**
17645
+ * Whether that version was already created, and so frozen, when the point was taken: its content is then that version's
17646
+ */
17647
+ frozen: boolean;
17648
+ title: string;
17649
+ /**
17650
+ * Who had last written that content
17651
+ */
17652
+ author: {
17653
+ type: "user" | "serviceAccount" | "system";
17654
+ id: string;
17655
+ };
17656
+ origin?: {
17657
+ threadId: string;
17658
+ runId: string;
17659
+ };
17660
+ /**
17661
+ * When that content was written
17662
+ */
17663
+ updatedAt: string;
17664
+ /**
17665
+ * Taken before an Agent turn's first write to the artifact, or before a restore
17666
+ */
17667
+ reason: "turn" | "restore";
17668
+ /**
17669
+ * With turn: the turn's run
17670
+ */
17671
+ turnRunId?: string;
17672
+ /**
17673
+ * When it was taken
17674
+ */
17675
+ createdAt: string;
17676
+ entry: string;
17677
+ files: Array<{
17678
+ /**
17679
+ * The file's path inside the artifact, such as figures/revenue.svg
17680
+ */
17681
+ path: string;
17682
+ file: {
17683
+ blobId: string;
17684
+ digest: string;
17685
+ sizeBytes: number;
17686
+ fileName?: string;
17687
+ mediaType?: string;
17688
+ logicalPath?: string;
17689
+ };
17690
+ }>;
17691
+ outline: {
17692
+ kind: "document";
17693
+ headings: Array<{
17694
+ depth: number;
17695
+ text: string;
17696
+ slug: string;
17697
+ }>;
17698
+ } | {
17699
+ kind: "sheet";
17700
+ sheets: Array<{
17701
+ name: string;
17702
+ /**
17703
+ * The rows of its CSV; none for a live sheet
17704
+ */
17705
+ rows: number;
17706
+ columns: Array<string>;
17707
+ /**
17708
+ * A live sheet's query, queries/<name>.json, whose rows each reader reads
17709
+ */
17710
+ query?: string;
17711
+ }>;
17712
+ charts: Array<string>;
17713
+ } | {
17714
+ kind: "slides";
17715
+ slides: Array<{
17716
+ title?: string;
17717
+ }>;
17718
+ } | {
17719
+ kind: "page";
17720
+ title?: string;
17721
+ } | {
17722
+ kind: "canvas";
17723
+ items: Array<{
17724
+ id: string;
17725
+ type: "board";
17726
+ title?: string;
17727
+ file: string;
17728
+ w: number;
17729
+ h: number;
17730
+ /**
17731
+ * What the board's preview is a picture of: a board kept as it was keeps it
17732
+ */
17733
+ renderKey?: string;
17734
+ } | {
17735
+ id: string;
17736
+ type: "section";
17737
+ title?: string;
17738
+ }>;
17739
+ /**
17740
+ * The modes each board has a preview in: both, or the one its theme.json pins
17741
+ */
17742
+ themes?: Array<"light" | "dark">;
17743
+ } | {
17744
+ kind: "file";
17745
+ mediaType: string;
17746
+ };
17747
+ references: Array<{
17748
+ address: string;
17749
+ as: "embed" | "link";
17750
+ at: string;
17751
+ resolvedVersion: number;
17752
+ }>;
17753
+ };
17754
+ };
17755
+ export type GetArtifactRestorePointResponse = GetArtifactRestorePointResponses[keyof GetArtifactRestorePointResponses];
17756
+ export type GetArtifactRestorePointFileContentData = {
17757
+ body?: never;
17758
+ path: {
17759
+ artifactId: string;
17760
+ /**
17761
+ * The revision whose content the restore point holds
17762
+ */
17763
+ revision: string;
17764
+ };
17765
+ query: {
17766
+ path: string;
17767
+ disposition?: "inline" | "attachment";
17768
+ /**
17769
+ * Client cache key; the route still resolves the current file
17770
+ */
17771
+ v?: string;
17772
+ };
17773
+ url: "/api/artifacts/{artifactId}/restore-points/{revision}/content";
17774
+ };
17775
+ export type GetArtifactRestorePointFileContentErrors = {
17776
+ /**
17777
+ * Response for status 400
17778
+ */
17779
+ 400: ErrorResponse;
17780
+ /**
17781
+ * Response for status 404
17782
+ */
17783
+ 404: ErrorResponse;
17784
+ /**
17785
+ * Requested byte range is not satisfiable
17786
+ */
17787
+ 416: unknown;
17788
+ /**
17789
+ * The storage role backing this content is not configured
17790
+ */
17791
+ 501: ErrorResponse;
17792
+ };
17793
+ export type GetArtifactRestorePointFileContentError = GetArtifactRestorePointFileContentErrors[keyof GetArtifactRestorePointFileContentErrors];
17794
+ export type GetArtifactRestorePointFileContentResponses = {
17795
+ /**
17796
+ * File content
17797
+ */
17798
+ 200: Blob | File;
17799
+ /**
17800
+ * Partial file content
17801
+ */
17802
+ 206: Blob | File;
17803
+ };
17804
+ export type GetArtifactRestorePointFileContentResponse = GetArtifactRestorePointFileContentResponses[keyof GetArtifactRestorePointFileContentResponses];
17805
+ export type RestoreArtifactData = {
17806
+ body: {
17807
+ /**
17808
+ * 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.
17809
+ */
17810
+ baseRevision?: number;
17811
+ };
17812
+ path: {
17813
+ artifactId: string;
17814
+ /**
17815
+ * The revision whose content the restore point holds
17816
+ */
17817
+ revision: string;
17818
+ };
17819
+ query?: never;
17820
+ url: "/api/artifacts/{artifactId}/restore-points/{revision}/restore";
17821
+ };
17822
+ export type RestoreArtifactErrors = {
17823
+ /**
17824
+ * Response for status 400
17825
+ */
17826
+ 400: {
17827
+ error: string;
17828
+ /**
17829
+ * 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.
17830
+ */
17831
+ code?: string;
17832
+ /**
17833
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
17834
+ */
17835
+ latest?: {
17836
+ version: number;
17837
+ revision: number;
17838
+ author: {
17839
+ type: "user" | "serviceAccount" | "system";
17840
+ id: string;
17841
+ };
17842
+ frozenBy?: {
17843
+ type: "user" | "serviceAccount" | "system";
17844
+ id: string;
17845
+ };
15477
17846
  };
15478
17847
  };
15479
17848
  /**
@@ -15482,18 +17851,23 @@ export type PublishArtifactVersionErrors = {
15482
17851
  403: {
15483
17852
  error: string;
15484
17853
  /**
15485
- * 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.
17854
+ * 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.
15486
17855
  */
15487
17856
  code?: string;
15488
17857
  /**
15489
- * With artifact_moved: the latest version and who published it
17858
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15490
17859
  */
15491
17860
  latest?: {
15492
17861
  version: number;
17862
+ revision: number;
15493
17863
  author: {
15494
17864
  type: "user" | "serviceAccount" | "system";
15495
17865
  id: string;
15496
17866
  };
17867
+ frozenBy?: {
17868
+ type: "user" | "serviceAccount" | "system";
17869
+ id: string;
17870
+ };
15497
17871
  };
15498
17872
  };
15499
17873
  /**
@@ -15502,18 +17876,23 @@ export type PublishArtifactVersionErrors = {
15502
17876
  404: {
15503
17877
  error: string;
15504
17878
  /**
15505
- * 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.
17879
+ * 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.
15506
17880
  */
15507
17881
  code?: string;
15508
17882
  /**
15509
- * With artifact_moved: the latest version and who published it
17883
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15510
17884
  */
15511
17885
  latest?: {
15512
17886
  version: number;
17887
+ revision: number;
15513
17888
  author: {
15514
17889
  type: "user" | "serviceAccount" | "system";
15515
17890
  id: string;
15516
17891
  };
17892
+ frozenBy?: {
17893
+ type: "user" | "serviceAccount" | "system";
17894
+ id: string;
17895
+ };
15517
17896
  };
15518
17897
  };
15519
17898
  /**
@@ -15522,18 +17901,23 @@ export type PublishArtifactVersionErrors = {
15522
17901
  409: {
15523
17902
  error: string;
15524
17903
  /**
15525
- * 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.
17904
+ * 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.
15526
17905
  */
15527
17906
  code?: string;
15528
17907
  /**
15529
- * With artifact_moved: the latest version and who published it
17908
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15530
17909
  */
15531
17910
  latest?: {
15532
17911
  version: number;
17912
+ revision: number;
15533
17913
  author: {
15534
17914
  type: "user" | "serviceAccount" | "system";
15535
17915
  id: string;
15536
17916
  };
17917
+ frozenBy?: {
17918
+ type: "user" | "serviceAccount" | "system";
17919
+ id: string;
17920
+ };
15537
17921
  };
15538
17922
  };
15539
17923
  /**
@@ -15542,27 +17926,32 @@ export type PublishArtifactVersionErrors = {
15542
17926
  501: {
15543
17927
  error: string;
15544
17928
  /**
15545
- * 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.
17929
+ * 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.
15546
17930
  */
15547
17931
  code?: string;
15548
17932
  /**
15549
- * With artifact_moved: the latest version and who published it
17933
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15550
17934
  */
15551
17935
  latest?: {
15552
17936
  version: number;
17937
+ revision: number;
15553
17938
  author: {
15554
17939
  type: "user" | "serviceAccount" | "system";
15555
17940
  id: string;
15556
17941
  };
17942
+ frozenBy?: {
17943
+ type: "user" | "serviceAccount" | "system";
17944
+ id: string;
17945
+ };
15557
17946
  };
15558
17947
  };
15559
17948
  };
15560
- export type PublishArtifactVersionError = PublishArtifactVersionErrors[keyof PublishArtifactVersionErrors];
15561
- export type PublishArtifactVersionResponses = {
17949
+ export type RestoreArtifactError = RestoreArtifactErrors[keyof RestoreArtifactErrors];
17950
+ export type RestoreArtifactResponses = {
15562
17951
  /**
15563
- * Response for status 201
17952
+ * Response for status 200
15564
17953
  */
15565
- 201: {
17954
+ 200: {
15566
17955
  artifact: {
15567
17956
  id: string;
15568
17957
  projectId: string;
@@ -15573,12 +17962,27 @@ export type PublishArtifactVersionResponses = {
15573
17962
  id: string;
15574
17963
  };
15575
17964
  latestVersion: number;
17965
+ /**
17966
+ * 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
17967
+ */
17968
+ revision: number;
15576
17969
  createdAt: string;
17970
+ /**
17971
+ * When the artifact last changed
17972
+ */
15577
17973
  updatedAt: string;
15578
17974
  };
15579
17975
  version: {
15580
17976
  artifactId: string;
15581
17977
  version: number;
17978
+ /**
17979
+ * The artifact's revision when this version last changed: the latest version's is the artifact's
17980
+ */
17981
+ revision: number;
17982
+ /**
17983
+ * Someone created this version: it never changes again. The latest version is open until then, and each write replaces its content
17984
+ */
17985
+ frozen: boolean;
15582
17986
  title: string;
15583
17987
  entry: string;
15584
17988
  files: Array<{
@@ -15634,11 +18038,19 @@ export type PublishArtifactVersionResponses = {
15634
18038
  file: string;
15635
18039
  w: number;
15636
18040
  h: number;
18041
+ /**
18042
+ * What the board's preview is a picture of: a board kept as it was keeps it
18043
+ */
18044
+ renderKey?: string;
15637
18045
  } | {
15638
18046
  id: string;
15639
18047
  type: "section";
15640
18048
  title?: string;
15641
18049
  }>;
18050
+ /**
18051
+ * The modes each board has a preview in: both, or the one its theme.json pins
18052
+ */
18053
+ themes?: Array<"light" | "dark">;
15642
18054
  } | {
15643
18055
  kind: "file";
15644
18056
  mediaType: string;
@@ -15649,24 +18061,49 @@ export type PublishArtifactVersionResponses = {
15649
18061
  at: string;
15650
18062
  resolvedVersion: number;
15651
18063
  }>;
18064
+ /**
18065
+ * Who last wrote its content
18066
+ */
15652
18067
  author: {
15653
18068
  type: "user" | "serviceAccount" | "system";
15654
18069
  id: string;
15655
18070
  };
18071
+ /**
18072
+ * The Agent turn and thread its content was last written from
18073
+ */
15656
18074
  origin?: {
15657
18075
  threadId: string;
15658
18076
  runId: string;
15659
18077
  };
18078
+ /**
18079
+ * When the version was opened
18080
+ */
15660
18081
  createdAt: string;
18082
+ /**
18083
+ * When its content was last written
18084
+ */
18085
+ updatedAt: string;
18086
+ /**
18087
+ * When it was created, which froze it
18088
+ */
18089
+ frozenAt?: string;
18090
+ /**
18091
+ * Who created it
18092
+ */
18093
+ frozenBy?: {
18094
+ type: "user" | "serviceAccount" | "system";
18095
+ id: string;
18096
+ };
18097
+ /**
18098
+ * 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
18099
+ */
18100
+ boardPreviews?: {
18101
+ [key: string]: "ready" | "pending" | "none";
18102
+ };
15661
18103
  };
15662
- warnings: Array<{
15663
- code: string;
15664
- message: string;
15665
- part?: string;
15666
- }>;
15667
18104
  };
15668
18105
  };
15669
- export type PublishArtifactVersionResponse = PublishArtifactVersionResponses[keyof PublishArtifactVersionResponses];
18106
+ export type RestoreArtifactResponse = RestoreArtifactResponses[keyof RestoreArtifactResponses];
15670
18107
  export type CreateArtifactFrameData = {
15671
18108
  body?: never;
15672
18109
  path: {
@@ -15686,18 +18123,23 @@ export type CreateArtifactFrameErrors = {
15686
18123
  403: {
15687
18124
  error: string;
15688
18125
  /**
15689
- * 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.
18126
+ * 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.
15690
18127
  */
15691
18128
  code?: string;
15692
18129
  /**
15693
- * With artifact_moved: the latest version and who published it
18130
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15694
18131
  */
15695
18132
  latest?: {
15696
18133
  version: number;
18134
+ revision: number;
15697
18135
  author: {
15698
18136
  type: "user" | "serviceAccount" | "system";
15699
18137
  id: string;
15700
18138
  };
18139
+ frozenBy?: {
18140
+ type: "user" | "serviceAccount" | "system";
18141
+ id: string;
18142
+ };
15701
18143
  };
15702
18144
  };
15703
18145
  /**
@@ -15706,18 +18148,23 @@ export type CreateArtifactFrameErrors = {
15706
18148
  404: {
15707
18149
  error: string;
15708
18150
  /**
15709
- * 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.
18151
+ * 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.
15710
18152
  */
15711
18153
  code?: string;
15712
18154
  /**
15713
- * With artifact_moved: the latest version and who published it
18155
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15714
18156
  */
15715
18157
  latest?: {
15716
18158
  version: number;
18159
+ revision: number;
15717
18160
  author: {
15718
18161
  type: "user" | "serviceAccount" | "system";
15719
18162
  id: string;
15720
18163
  };
18164
+ frozenBy?: {
18165
+ type: "user" | "serviceAccount" | "system";
18166
+ id: string;
18167
+ };
15721
18168
  };
15722
18169
  };
15723
18170
  /**
@@ -15726,18 +18173,23 @@ export type CreateArtifactFrameErrors = {
15726
18173
  409: {
15727
18174
  error: string;
15728
18175
  /**
15729
- * 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.
18176
+ * 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.
15730
18177
  */
15731
18178
  code?: string;
15732
18179
  /**
15733
- * With artifact_moved: the latest version and who published it
18180
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15734
18181
  */
15735
18182
  latest?: {
15736
18183
  version: number;
18184
+ revision: number;
15737
18185
  author: {
15738
18186
  type: "user" | "serviceAccount" | "system";
15739
18187
  id: string;
15740
18188
  };
18189
+ frozenBy?: {
18190
+ type: "user" | "serviceAccount" | "system";
18191
+ id: string;
18192
+ };
15741
18193
  };
15742
18194
  };
15743
18195
  /**
@@ -15746,18 +18198,23 @@ export type CreateArtifactFrameErrors = {
15746
18198
  501: {
15747
18199
  error: string;
15748
18200
  /**
15749
- * 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.
18201
+ * 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.
15750
18202
  */
15751
18203
  code?: string;
15752
18204
  /**
15753
- * With artifact_moved: the latest version and who published it
18205
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15754
18206
  */
15755
18207
  latest?: {
15756
18208
  version: number;
18209
+ revision: number;
15757
18210
  author: {
15758
18211
  type: "user" | "serviceAccount" | "system";
15759
18212
  id: string;
15760
18213
  };
18214
+ frozenBy?: {
18215
+ type: "user" | "serviceAccount" | "system";
18216
+ id: string;
18217
+ };
15761
18218
  };
15762
18219
  };
15763
18220
  };
@@ -15797,18 +18254,23 @@ export type GetArtifactVersionErrors = {
15797
18254
  403: {
15798
18255
  error: string;
15799
18256
  /**
15800
- * 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.
18257
+ * 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.
15801
18258
  */
15802
18259
  code?: string;
15803
18260
  /**
15804
- * With artifact_moved: the latest version and who published it
18261
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15805
18262
  */
15806
18263
  latest?: {
15807
18264
  version: number;
18265
+ revision: number;
15808
18266
  author: {
15809
18267
  type: "user" | "serviceAccount" | "system";
15810
18268
  id: string;
15811
18269
  };
18270
+ frozenBy?: {
18271
+ type: "user" | "serviceAccount" | "system";
18272
+ id: string;
18273
+ };
15812
18274
  };
15813
18275
  };
15814
18276
  /**
@@ -15817,18 +18279,23 @@ export type GetArtifactVersionErrors = {
15817
18279
  404: {
15818
18280
  error: string;
15819
18281
  /**
15820
- * 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.
18282
+ * 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.
15821
18283
  */
15822
18284
  code?: string;
15823
18285
  /**
15824
- * With artifact_moved: the latest version and who published it
18286
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15825
18287
  */
15826
18288
  latest?: {
15827
18289
  version: number;
18290
+ revision: number;
15828
18291
  author: {
15829
18292
  type: "user" | "serviceAccount" | "system";
15830
18293
  id: string;
15831
18294
  };
18295
+ frozenBy?: {
18296
+ type: "user" | "serviceAccount" | "system";
18297
+ id: string;
18298
+ };
15832
18299
  };
15833
18300
  };
15834
18301
  /**
@@ -15837,18 +18304,23 @@ export type GetArtifactVersionErrors = {
15837
18304
  501: {
15838
18305
  error: string;
15839
18306
  /**
15840
- * 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.
18307
+ * 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.
15841
18308
  */
15842
18309
  code?: string;
15843
18310
  /**
15844
- * With artifact_moved: the latest version and who published it
18311
+ * With artifact_moved: the artifact's latest version, its revision, who last wrote it, and who created it once it is frozen
15845
18312
  */
15846
18313
  latest?: {
15847
18314
  version: number;
18315
+ revision: number;
15848
18316
  author: {
15849
18317
  type: "user" | "serviceAccount" | "system";
15850
18318
  id: string;
15851
18319
  };
18320
+ frozenBy?: {
18321
+ type: "user" | "serviceAccount" | "system";
18322
+ id: string;
18323
+ };
15852
18324
  };
15853
18325
  };
15854
18326
  };
@@ -15860,6 +18332,14 @@ export type GetArtifactVersionResponses = {
15860
18332
  200: {
15861
18333
  artifactId: string;
15862
18334
  version: number;
18335
+ /**
18336
+ * The artifact's revision when this version last changed: the latest version's is the artifact's
18337
+ */
18338
+ revision: number;
18339
+ /**
18340
+ * Someone created this version: it never changes again. The latest version is open until then, and each write replaces its content
18341
+ */
18342
+ frozen: boolean;
15863
18343
  title: string;
15864
18344
  entry: string;
15865
18345
  files: Array<{
@@ -15915,11 +18395,19 @@ export type GetArtifactVersionResponses = {
15915
18395
  file: string;
15916
18396
  w: number;
15917
18397
  h: number;
18398
+ /**
18399
+ * What the board's preview is a picture of: a board kept as it was keeps it
18400
+ */
18401
+ renderKey?: string;
15918
18402
  } | {
15919
18403
  id: string;
15920
18404
  type: "section";
15921
18405
  title?: string;
15922
18406
  }>;
18407
+ /**
18408
+ * The modes each board has a preview in: both, or the one its theme.json pins
18409
+ */
18410
+ themes?: Array<"light" | "dark">;
15923
18411
  } | {
15924
18412
  kind: "file";
15925
18413
  mediaType: string;
@@ -15930,18 +18418,111 @@ export type GetArtifactVersionResponses = {
15930
18418
  at: string;
15931
18419
  resolvedVersion: number;
15932
18420
  }>;
18421
+ /**
18422
+ * Who last wrote its content
18423
+ */
15933
18424
  author: {
15934
18425
  type: "user" | "serviceAccount" | "system";
15935
18426
  id: string;
15936
18427
  };
18428
+ /**
18429
+ * The Agent turn and thread its content was last written from
18430
+ */
15937
18431
  origin?: {
15938
18432
  threadId: string;
15939
18433
  runId: string;
15940
18434
  };
18435
+ /**
18436
+ * When the version was opened
18437
+ */
15941
18438
  createdAt: string;
18439
+ /**
18440
+ * When its content was last written
18441
+ */
18442
+ updatedAt: string;
18443
+ /**
18444
+ * When it was created, which froze it
18445
+ */
18446
+ frozenAt?: string;
18447
+ /**
18448
+ * Who created it
18449
+ */
18450
+ frozenBy?: {
18451
+ type: "user" | "serviceAccount" | "system";
18452
+ id: string;
18453
+ };
18454
+ /**
18455
+ * 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
18456
+ */
18457
+ boardPreviews?: {
18458
+ [key: string]: "ready" | "pending" | "none";
18459
+ };
15942
18460
  };
15943
18461
  };
15944
18462
  export type GetArtifactVersionResponse = GetArtifactVersionResponses[keyof GetArtifactVersionResponses];
18463
+ export type GetArtifactBoardPreviewData = {
18464
+ body?: never;
18465
+ path: {
18466
+ artifactId: string;
18467
+ /**
18468
+ * A version number, or "latest"
18469
+ */
18470
+ version: string;
18471
+ /**
18472
+ * The board's id in the canvas
18473
+ */
18474
+ board: string;
18475
+ };
18476
+ query?: {
18477
+ /**
18478
+ * The reader's mode; a canvas whose theme.json pins one is pictured only in it
18479
+ */
18480
+ theme?: "light" | "dark";
18481
+ /**
18482
+ * 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
18483
+ */
18484
+ size?: "full" | "small";
18485
+ /**
18486
+ * 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
18487
+ */
18488
+ revision?: number;
18489
+ /**
18490
+ * 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
18491
+ */
18492
+ key?: string;
18493
+ /**
18494
+ * Share grant selector for elements that cannot send the x-sixb-share-grant header
18495
+ */
18496
+ shareGrant?: string;
18497
+ };
18498
+ url: "/api/artifacts/{artifactId}/versions/{version}/boards/{board}/preview";
18499
+ };
18500
+ export type GetArtifactBoardPreviewErrors = {
18501
+ /**
18502
+ * Response for status 400
18503
+ */
18504
+ 400: ArtifactErrorResponse;
18505
+ /**
18506
+ * Response for status 403
18507
+ */
18508
+ 403: ArtifactErrorResponse;
18509
+ /**
18510
+ * Response for status 404
18511
+ */
18512
+ 404: ArtifactErrorResponse;
18513
+ /**
18514
+ * Response for status 501
18515
+ */
18516
+ 501: ArtifactErrorResponse;
18517
+ };
18518
+ export type GetArtifactBoardPreviewError = GetArtifactBoardPreviewErrors[keyof GetArtifactBoardPreviewErrors];
18519
+ export type GetArtifactBoardPreviewResponses = {
18520
+ /**
18521
+ * The board's preview
18522
+ */
18523
+ 200: Blob | File;
18524
+ };
18525
+ export type GetArtifactBoardPreviewResponse = GetArtifactBoardPreviewResponses[keyof GetArtifactBoardPreviewResponses];
15945
18526
  export type GetArtifactQueryData = {
15946
18527
  body?: never;
15947
18528
  path: {
@@ -16004,6 +18585,10 @@ export type GetArtifactFileContentData = {
16004
18585
  * Client cache key; the route still resolves the current file
16005
18586
  */
16006
18587
  v?: string;
18588
+ /**
18589
+ * Share grant selector for elements that cannot send the x-sixb-share-grant header
18590
+ */
18591
+ shareGrant?: string;
16007
18592
  };
16008
18593
  url: "/api/artifacts/{artifactId}/versions/{version}/content";
16009
18594
  };
@@ -16053,6 +18638,10 @@ export type HeadArtifactFileContentData = {
16053
18638
  * Client cache key; the route still resolves the current file
16054
18639
  */
16055
18640
  v?: string;
18641
+ /**
18642
+ * Share grant selector for elements that cannot send the x-sixb-share-grant header
18643
+ */
18644
+ shareGrant?: string;
16056
18645
  };
16057
18646
  url: "/api/artifacts/{artifactId}/versions/{version}/content";
16058
18647
  };
@@ -16872,8 +19461,8 @@ export type ListEventsData = {
16872
19461
  body?: never;
16873
19462
  path?: never;
16874
19463
  query?: {
16875
- topic?: "objects" | "telemetry" | "links" | "schedules" | "syncs" | "pipelines" | "workflows" | "datasets" | "rules" | "users";
16876
- type?: "object.created" | "object.updated" | "object.deleted" | "telemetry.appended" | "link.created" | "link.updated" | "link.deleted" | "schedule.triggered" | "sync.run.started" | "sync.run.finished" | "pipeline.run.started" | "pipeline.run.step.started" | "pipeline.run.step.finished" | "pipeline.run.finished" | "workflow.run.queued" | "workflow.run.started" | "workflow.run.node.started" | "workflow.run.waiting" | "workflow.run.node.waiting" | "workflow.run.node.finished" | "workflow.run.finished" | "workflow.intervention.requested" | "workflow.intervention.submitted" | "workflow.intervention.cancelled" | "workflow.intervention.expired" | "dataset.version.committed" | "rule.triggered" | "rule.resolved" | "user.joined" | "user.suspended" | "user.reactivated" | "user.invited" | "user.profile.updated";
19464
+ topic?: "objects" | "telemetry" | "links" | "schedules" | "syncs" | "pipelines" | "workflows" | "datasets" | "rules" | "users" | "artifacts";
19465
+ type?: "object.created" | "object.updated" | "object.deleted" | "telemetry.appended" | "link.created" | "link.updated" | "link.deleted" | "schedule.triggered" | "sync.run.started" | "sync.run.finished" | "pipeline.run.started" | "pipeline.run.step.started" | "pipeline.run.step.finished" | "pipeline.run.finished" | "workflow.run.queued" | "workflow.run.started" | "workflow.run.node.started" | "workflow.run.waiting" | "workflow.run.node.waiting" | "workflow.run.node.finished" | "workflow.run.finished" | "workflow.intervention.requested" | "workflow.intervention.submitted" | "workflow.intervention.cancelled" | "workflow.intervention.expired" | "dataset.version.committed" | "rule.triggered" | "rule.resolved" | "user.joined" | "user.suspended" | "user.reactivated" | "user.invited" | "user.profile.updated" | "artifact.updated" | "artifact.commented";
16877
19466
  afterCursor?: string;
16878
19467
  limit?: string;
16879
19468
  };
@@ -17689,8 +20278,8 @@ export type ListEventsResponses = {
17689
20278
  [key: string]: unknown;
17690
20279
  } | null;
17691
20280
  };
17692
- type: "schedule.triggered" | "sync.run.started" | "sync.run.finished" | "pipeline.run.started" | "pipeline.run.step.started" | "pipeline.run.step.finished" | "pipeline.run.finished" | "workflow.run.queued" | "workflow.run.started" | "workflow.run.node.started" | "workflow.run.waiting" | "workflow.run.node.waiting" | "workflow.run.node.finished" | "workflow.run.finished" | "workflow.intervention.requested" | "workflow.intervention.submitted" | "workflow.intervention.cancelled" | "workflow.intervention.expired" | "dataset.version.committed" | "rule.triggered" | "rule.resolved" | "user.joined" | "user.suspended" | "user.reactivated" | "user.invited" | "user.profile.updated";
17693
- topic: "objects" | "telemetry" | "links" | "schedules" | "syncs" | "pipelines" | "workflows" | "datasets" | "rules" | "users";
20281
+ type: "schedule.triggered" | "sync.run.started" | "sync.run.finished" | "pipeline.run.started" | "pipeline.run.step.started" | "pipeline.run.step.finished" | "pipeline.run.finished" | "workflow.run.queued" | "workflow.run.started" | "workflow.run.node.started" | "workflow.run.waiting" | "workflow.run.node.waiting" | "workflow.run.node.finished" | "workflow.run.finished" | "workflow.intervention.requested" | "workflow.intervention.submitted" | "workflow.intervention.cancelled" | "workflow.intervention.expired" | "dataset.version.committed" | "rule.triggered" | "rule.resolved" | "user.joined" | "user.suspended" | "user.reactivated" | "user.invited" | "user.profile.updated" | "artifact.updated" | "artifact.commented";
20282
+ topic: "objects" | "telemetry" | "links" | "schedules" | "syncs" | "pipelines" | "workflows" | "datasets" | "rules" | "users" | "artifacts";
17694
20283
  payload: {
17695
20284
  [key: string]: unknown;
17696
20285
  };
@@ -18333,7 +20922,7 @@ export type ListProjectionsResponses = {
18333
20922
  [key: string]: string;
18334
20923
  };
18335
20924
  users?: {
18336
- [key: string]: "email";
20925
+ [key: string]: "email" | "id";
18337
20926
  };
18338
20927
  links: {
18339
20928
  [key: string]: {
@@ -18818,7 +21407,7 @@ export type GetProjectionResponses = {
18818
21407
  [key: string]: string;
18819
21408
  };
18820
21409
  users?: {
18821
- [key: string]: "email";
21410
+ [key: string]: "email" | "id";
18822
21411
  };
18823
21412
  links: {
18824
21413
  [key: string]: {