@zocomputer/system-api 0.1.2 → 0.1.4

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.
@@ -103,6 +103,12 @@ export interface ZoAgentCancelOutputV1 {
103
103
  state: ("idle" | "cancelling");
104
104
  }
105
105
  export interface ZoAgentCreateInputV1 {
106
+ /**
107
+ * @maxItems 100
108
+ *
109
+ * Items: A tag ID or name; unknown names are created, unknown IDs are refused.
110
+ */
111
+ tags?: string[];
106
112
  workspace_id: string;
107
113
  display_name: string;
108
114
  /**
@@ -118,9 +124,13 @@ export interface ZoAgentCreateInputV1 {
118
124
  */
119
125
  export interface ZoAgentCreateInputV1NativeConfiguration {
120
126
  /**
121
- * Model identifier the runner calls.
127
+ * The model a new session starts with. Each session keeps its own choice after that.
122
128
  */
123
129
  model: string;
130
+ /**
131
+ * The reasoning level a new session starts with, one the model's catalog offers; null for the model's default.
132
+ */
133
+ reasoning?: (string | null);
124
134
  /**
125
135
  * The Agent's instructions.
126
136
  */
@@ -164,9 +174,13 @@ export interface ZoAgentCreateOutputV1 {
164
174
  */
165
175
  export interface ZoAgentCreateOutputV1NativeConfiguration {
166
176
  /**
167
- * Model identifier the runner calls.
177
+ * The model a new session starts with. Each session keeps its own choice after that.
168
178
  */
169
179
  model: string;
180
+ /**
181
+ * The reasoning level a new session starts with, one the model's catalog offers; null for the model's default.
182
+ */
183
+ reasoning?: (string | null);
170
184
  /**
171
185
  * The Agent's instructions.
172
186
  */
@@ -248,9 +262,13 @@ export interface ZoAgentGetOutputV1 {
248
262
  */
249
263
  export interface ZoAgentGetOutputV1NativeConfiguration {
250
264
  /**
251
- * Model identifier the runner calls.
265
+ * The model a new session starts with. Each session keeps its own choice after that.
252
266
  */
253
267
  model: string;
268
+ /**
269
+ * The reasoning level a new session starts with, one the model's catalog offers; null for the model's default.
270
+ */
271
+ reasoning?: (string | null);
254
272
  /**
255
273
  * The Agent's instructions.
256
274
  */
@@ -328,9 +346,13 @@ export interface ZoAgentListOutputV1Agent {
328
346
  */
329
347
  export interface ZoAgentListOutputV1NativeConfiguration {
330
348
  /**
331
- * Model identifier the runner calls.
349
+ * The model a new session starts with. Each session keeps its own choice after that.
332
350
  */
333
351
  model: string;
352
+ /**
353
+ * The reasoning level a new session starts with, one the model's catalog offers; null for the model's default.
354
+ */
355
+ reasoning?: (string | null);
334
356
  /**
335
357
  * The Agent's instructions.
336
358
  */
@@ -458,6 +480,14 @@ export interface ZoAgentListMessagesOutputV1MessageDelivery {
458
480
  */
459
481
  outcome: (("completed" | "cancelled" | "interrupted" | "failed") | null);
460
482
  outcome_reason: (string | null);
483
+ /**
484
+ * The model the message was admitted with: the one it named, else the session's.
485
+ */
486
+ model: (string | null);
487
+ /**
488
+ * The reasoning level the message was admitted with; null for the model's default.
489
+ */
490
+ reasoning: (string | null);
461
491
  }
462
492
  export interface ZoAgentListMessagesQueryV1 {
463
493
  /**
@@ -484,6 +514,14 @@ export interface ZoAgentSendInputV1 {
484
514
  * How the message affects work already running in the session: wait behind it, join it, or stop it.
485
515
  */
486
516
  priority?: ("queue" | "steer" | "interrupt");
517
+ /**
518
+ * Make this the session's model, from the turn this message starts; a steer that joins a running turn changes the next one. Omit to keep the session's choice.
519
+ */
520
+ model?: (string | null);
521
+ /**
522
+ * The model's reasoning level; null for the model's default. Requires model.
523
+ */
524
+ reasoning?: (string | null);
487
525
  }
488
526
  export interface ZoAgentSendInputV1TextBlock {
489
527
  type: "text";
@@ -544,9 +582,13 @@ export interface ZoAgentUpdateInputV1 {
544
582
  */
545
583
  export interface ZoAgentUpdateInputV1NativeConfiguration {
546
584
  /**
547
- * Model identifier the runner calls.
585
+ * The model a new session starts with. Each session keeps its own choice after that.
548
586
  */
549
587
  model: string;
588
+ /**
589
+ * The reasoning level a new session starts with, one the model's catalog offers; null for the model's default.
590
+ */
591
+ reasoning?: (string | null);
550
592
  /**
551
593
  * The Agent's instructions.
552
594
  */
@@ -590,9 +632,13 @@ export interface ZoAgentUpdateOutputV1 {
590
632
  */
591
633
  export interface ZoAgentUpdateOutputV1NativeConfiguration {
592
634
  /**
593
- * Model identifier the runner calls.
635
+ * The model a new session starts with. Each session keeps its own choice after that.
594
636
  */
595
637
  model: string;
638
+ /**
639
+ * The reasoning level a new session starts with, one the model's catalog offers; null for the model's default.
640
+ */
641
+ reasoning?: (string | null);
596
642
  /**
597
643
  * The Agent's instructions.
598
644
  */
@@ -651,6 +697,14 @@ export interface ZoAgentSessionGetOutputV1 {
651
697
  * When the session's newest message or event was delivered to it; created_at when it has none.
652
698
  */
653
699
  last_activity_at: string;
700
+ /**
701
+ * The model the session's next inputs run with.
702
+ */
703
+ model: string;
704
+ /**
705
+ * The reasoning level the session's next inputs run with; null for the model's default.
706
+ */
707
+ reasoning: (string | null);
654
708
  /**
655
709
  * Server-sent events of the session's history, then its live output, read with the same Bearer credential. Authorized as zo.agent_session.history.
656
710
  */
@@ -709,6 +763,14 @@ export interface ZoAgentSessionListOutputV1AgentSession {
709
763
  * When the session's newest message or event was delivered to it; created_at when it has none.
710
764
  */
711
765
  last_activity_at: string;
766
+ /**
767
+ * The model the session's next inputs run with.
768
+ */
769
+ model: string;
770
+ /**
771
+ * The reasoning level the session's next inputs run with; null for the model's default.
772
+ */
773
+ reasoning: (string | null);
712
774
  }
713
775
  export interface ZoAgentSessionListQueryV1 {
714
776
  /**
@@ -741,6 +803,14 @@ export interface ZoAgentSessionListWorkspaceOutputV1AgentSession {
741
803
  * When the session's newest message or event was delivered to it; created_at when it has none.
742
804
  */
743
805
  last_activity_at: string;
806
+ /**
807
+ * The model the session's next inputs run with.
808
+ */
809
+ model: string;
810
+ /**
811
+ * The reasoning level the session's next inputs run with; null for the model's default.
812
+ */
813
+ reasoning: (string | null);
744
814
  }
745
815
  export interface ZoAgentSessionListWorkspaceQueryV1 {
746
816
  /**
@@ -759,6 +829,298 @@ export interface ZoAgentSessionListWorkspaceQueryV1 {
759
829
  agent_id?: (string | null);
760
830
  };
761
831
  }
832
+ export interface ZoBillingListRatesInputV1 {
833
+ workspace_id: string;
834
+ }
835
+ export interface ZoBillingListRatesOutputV1 {
836
+ workspace_id: string;
837
+ observed_at: string;
838
+ rates: ZoBillingListRatesOutputV1BillingRate[];
839
+ next_cursor: (string | null);
840
+ }
841
+ export interface ZoBillingListRatesOutputV1BillingRate {
842
+ /**
843
+ * Current catalog key; not an immutable historical price identifier.
844
+ */
845
+ rate_key: string;
846
+ product: string;
847
+ meter: string;
848
+ price: ZoBillingListRatesOutputV1AppliedPrice;
849
+ model_id?: (string | null);
850
+ tool_name?: (string | null);
851
+ provider?: (string | null);
852
+ sku?: (string | null);
853
+ resource_kind?: (string | null);
854
+ conditions?: ZoBillingListRatesOutputV1RateConditions;
855
+ promotional_end?: (string | null);
856
+ applicability?: ("active" | "no_usage_feed");
857
+ }
858
+ export interface ZoBillingListRatesOutputV1AppliedPrice {
859
+ amount: string;
860
+ currency?: "USD";
861
+ per: ZoBillingListRatesOutputV1BillingQuantity;
862
+ tariff_version?: (string | null);
863
+ usage_price_multiplier?: (string | null);
864
+ }
865
+ export interface ZoBillingListRatesOutputV1BillingQuantity {
866
+ amount: string;
867
+ unit: string;
868
+ }
869
+ export interface ZoBillingListRatesOutputV1RateConditions {
870
+ /**
871
+ * Inclusive request-size lower bound.
872
+ */
873
+ request_input_tokens_min?: (number | null);
874
+ /**
875
+ * Exclusive request-size upper bound.
876
+ */
877
+ request_input_tokens_max?: (number | null);
878
+ /**
879
+ * The matching tier prices the whole request.
880
+ */
881
+ whole_request?: boolean;
882
+ operation?: (string | null);
883
+ resolution?: (string | null);
884
+ quality?: (string | null);
885
+ duration_seconds?: (string | null);
886
+ quantity_min?: (string | null);
887
+ quantity_max?: (string | null);
888
+ included_quantity?: (string | null);
889
+ default_quantity?: (string | null);
890
+ quantity_argument?: (string | null);
891
+ selector?: {
892
+ [k: string]: JsonValue;
893
+ };
894
+ rounding?: ("none" | "ceil_step");
895
+ }
896
+ export interface ZoBillingListRatesQueryV1 {
897
+ /**
898
+ * Rows per page, at most 200; a larger value is reduced to it.
899
+ */
900
+ limit?: number;
901
+ /**
902
+ * The previous page's next_cursor, sent with the same sort, filter and search.
903
+ */
904
+ cursor?: string;
905
+ sort?: "rate_key.asc";
906
+ filter?: {
907
+ product?: (string | null);
908
+ meter?: (string | null);
909
+ model_id?: (string | null);
910
+ tool_name?: (string | null);
911
+ provider?: (string | null);
912
+ sku?: (string | null);
913
+ };
914
+ }
915
+ export interface ZoBillingListUsageEntriesInputV1 {
916
+ workspace_id: string;
917
+ period: ZoBillingListUsageEntriesInputV1BillingPeriod;
918
+ }
919
+ export interface ZoBillingListUsageEntriesInputV1BillingPeriod {
920
+ /**
921
+ * An ISO 8601 timestamp with a time zone.
922
+ */
923
+ start: string;
924
+ /**
925
+ * An ISO 8601 timestamp with a time zone.
926
+ */
927
+ end: string;
928
+ }
929
+ export interface ZoBillingListUsageEntriesOutputV1 {
930
+ workspace_id: string;
931
+ period: ZoBillingListUsageEntriesOutputV1BillingPeriod;
932
+ history_mode?: "forward_only";
933
+ observed_at: string;
934
+ entries: ZoBillingListUsageEntriesOutputV1UsageEntry[];
935
+ next_cursor: (string | null);
936
+ }
937
+ export interface ZoBillingListUsageEntriesOutputV1BillingPeriod {
938
+ /**
939
+ * An ISO 8601 timestamp with a time zone.
940
+ */
941
+ start: string;
942
+ /**
943
+ * An ISO 8601 timestamp with a time zone.
944
+ */
945
+ end: string;
946
+ }
947
+ export interface ZoBillingListUsageEntriesOutputV1UsageEntry {
948
+ id: string;
949
+ usage_id: string;
950
+ product: string;
951
+ meter: string;
952
+ quantity: ZoBillingListUsageEntriesOutputV1BillingQuantity;
953
+ cost: ZoBillingListUsageEntriesOutputV1BillingMoney;
954
+ /**
955
+ * Null for an explicit occurrence rounding adjustment.
956
+ */
957
+ applied_price: (ZoBillingListUsageEntriesOutputV1AppliedPrice | null);
958
+ occurred_at: string;
959
+ recorded_at: string;
960
+ interval_start: (string | null);
961
+ interval_end: (string | null);
962
+ attribution: ZoBillingListUsageEntriesOutputV1UsageAttribution;
963
+ correction_of_entry_id: (string | null);
964
+ correction_of_usage_id: (string | null);
965
+ }
966
+ export interface ZoBillingListUsageEntriesOutputV1BillingQuantity {
967
+ amount: string;
968
+ unit: string;
969
+ }
970
+ export interface ZoBillingListUsageEntriesOutputV1BillingMoney {
971
+ amount: string;
972
+ currency?: "USD";
973
+ }
974
+ export interface ZoBillingListUsageEntriesOutputV1AppliedPrice {
975
+ amount: string;
976
+ currency?: "USD";
977
+ per: ZoBillingListUsageEntriesOutputV1BillingQuantity;
978
+ tariff_version?: (string | null);
979
+ usage_price_multiplier?: (string | null);
980
+ }
981
+ export interface ZoBillingListUsageEntriesOutputV1UsageAttribution {
982
+ model_id?: (string | null);
983
+ resource_id?: (string | null);
984
+ /**
985
+ * Current name, including protected resources; null if unavailable.
986
+ */
987
+ resource_name?: (string | null);
988
+ agent_id?: (string | null);
989
+ agent_session_id?: (string | null);
990
+ agent_session_name?: (string | null);
991
+ turn_id?: (string | null);
992
+ host_id?: (string | null);
993
+ conversation_id?: (string | null);
994
+ run_id?: (string | null);
995
+ tool_call_id?: (string | null);
996
+ tool_name?: (string | null);
997
+ provider?: (string | null);
998
+ sku?: (string | null);
999
+ bucket?: (string | null);
1000
+ operation?: (string | null);
1001
+ attribution_kind?: (string | null);
1002
+ provider_request_id?: (string | null);
1003
+ catalog_revision?: (string | null);
1004
+ gpu_type?: (string | null);
1005
+ storage_component?: (string | null);
1006
+ billing_model_slug?: (string | null);
1007
+ output_count?: (number | null);
1008
+ }
1009
+ export interface ZoBillingListUsageEntriesQueryV1 {
1010
+ /**
1011
+ * Rows per page, at most 200; a larger value is reduced to it.
1012
+ */
1013
+ limit?: number;
1014
+ /**
1015
+ * The previous page's next_cursor, sent with the same sort, filter and search.
1016
+ */
1017
+ cursor?: string;
1018
+ sort?: ("occurred_at.desc" | "occurred_at.asc");
1019
+ filter?: {
1020
+ product?: (string | null);
1021
+ meter?: (string | null);
1022
+ model_id?: (string | null);
1023
+ resource_id?: (string | null);
1024
+ agent_id?: (string | null);
1025
+ agent_session_id?: (string | null);
1026
+ turn_id?: (string | null);
1027
+ usage_id?: (string | null);
1028
+ };
1029
+ }
1030
+ export interface ZoBillingSummarizeUsageInputV1 {
1031
+ workspace_id: string;
1032
+ period: ZoBillingSummarizeUsageInputV1BillingPeriod;
1033
+ /**
1034
+ * @maxItems 4
1035
+ */
1036
+ group_by?: [] | [("product" | "meter" | "model_id" | "resource_id" | "agent_id" | "agent_session_id" | "turn_id" | "usage_id")] | [("product" | "meter" | "model_id" | "resource_id" | "agent_id" | "agent_session_id" | "turn_id" | "usage_id"), ("product" | "meter" | "model_id" | "resource_id" | "agent_id" | "agent_session_id" | "turn_id" | "usage_id")] | [("product" | "meter" | "model_id" | "resource_id" | "agent_id" | "agent_session_id" | "turn_id" | "usage_id"), ("product" | "meter" | "model_id" | "resource_id" | "agent_id" | "agent_session_id" | "turn_id" | "usage_id"), ("product" | "meter" | "model_id" | "resource_id" | "agent_id" | "agent_session_id" | "turn_id" | "usage_id")] | [("product" | "meter" | "model_id" | "resource_id" | "agent_id" | "agent_session_id" | "turn_id" | "usage_id"), ("product" | "meter" | "model_id" | "resource_id" | "agent_id" | "agent_session_id" | "turn_id" | "usage_id"), ("product" | "meter" | "model_id" | "resource_id" | "agent_id" | "agent_session_id" | "turn_id" | "usage_id"), ("product" | "meter" | "model_id" | "resource_id" | "agent_id" | "agent_session_id" | "turn_id" | "usage_id")];
1037
+ /**
1038
+ * Add UTC calendar-day buckets to each group.
1039
+ */
1040
+ daily?: boolean;
1041
+ }
1042
+ export interface ZoBillingSummarizeUsageInputV1BillingPeriod {
1043
+ /**
1044
+ * An ISO 8601 timestamp with a time zone.
1045
+ */
1046
+ start: string;
1047
+ /**
1048
+ * An ISO 8601 timestamp with a time zone.
1049
+ */
1050
+ end: string;
1051
+ }
1052
+ export interface ZoBillingSummarizeUsageOutputV1 {
1053
+ workspace_id: string;
1054
+ period: ZoBillingSummarizeUsageOutputV1BillingPeriod;
1055
+ history_mode?: "forward_only";
1056
+ observed_at: string;
1057
+ recorded_cost: ZoBillingSummarizeUsageOutputV1BillingMoney;
1058
+ entry_count: number;
1059
+ groups: ZoBillingSummarizeUsageOutputV1UsageGroup[];
1060
+ next_cursor: (string | null);
1061
+ }
1062
+ export interface ZoBillingSummarizeUsageOutputV1BillingPeriod {
1063
+ /**
1064
+ * An ISO 8601 timestamp with a time zone.
1065
+ */
1066
+ start: string;
1067
+ /**
1068
+ * An ISO 8601 timestamp with a time zone.
1069
+ */
1070
+ end: string;
1071
+ }
1072
+ /**
1073
+ * Signed cost over every matching recorded entry, across all pages.
1074
+ */
1075
+ export interface ZoBillingSummarizeUsageOutputV1BillingMoney {
1076
+ amount: string;
1077
+ currency?: "USD";
1078
+ }
1079
+ export interface ZoBillingSummarizeUsageOutputV1UsageGroup {
1080
+ /**
1081
+ * Stable opaque ordering key for this combination of dimensions and UTC day.
1082
+ */
1083
+ key: string;
1084
+ dimensions: ZoBillingSummarizeUsageOutputV1UsageFilter;
1085
+ day: (string | null);
1086
+ recorded_cost: ZoBillingSummarizeUsageOutputV1BillingMoney1;
1087
+ entry_count: number;
1088
+ }
1089
+ export interface ZoBillingSummarizeUsageOutputV1UsageFilter {
1090
+ product?: (string | null);
1091
+ meter?: (string | null);
1092
+ model_id?: (string | null);
1093
+ resource_id?: (string | null);
1094
+ agent_id?: (string | null);
1095
+ agent_session_id?: (string | null);
1096
+ turn_id?: (string | null);
1097
+ usage_id?: (string | null);
1098
+ }
1099
+ export interface ZoBillingSummarizeUsageOutputV1BillingMoney1 {
1100
+ amount: string;
1101
+ currency?: "USD";
1102
+ }
1103
+ export interface ZoBillingSummarizeUsageQueryV1 {
1104
+ /**
1105
+ * Rows per page, at most 200; a larger value is reduced to it.
1106
+ */
1107
+ limit?: number;
1108
+ /**
1109
+ * The previous page's next_cursor, sent with the same sort, filter and search.
1110
+ */
1111
+ cursor?: string;
1112
+ sort?: "key.asc";
1113
+ filter?: {
1114
+ product?: (string | null);
1115
+ meter?: (string | null);
1116
+ model_id?: (string | null);
1117
+ resource_id?: (string | null);
1118
+ agent_id?: (string | null);
1119
+ agent_session_id?: (string | null);
1120
+ turn_id?: (string | null);
1121
+ usage_id?: (string | null);
1122
+ };
1123
+ }
762
1124
  export interface ZoConnectionAuthorizeInputV1 {
763
1125
  connection_id: string;
764
1126
  expected_revision: number;
@@ -800,6 +1162,12 @@ export interface ZoConnectionAuthorizeOutputV1KeyAttached {
800
1162
  revision: number;
801
1163
  }
802
1164
  export interface ZoConnectionCreateInputV1 {
1165
+ /**
1166
+ * @maxItems 100
1167
+ *
1168
+ * Items: A tag ID or name; unknown names are created, unknown IDs are refused.
1169
+ */
1170
+ tags?: string[];
803
1171
  workspace_id: string;
804
1172
  /**
805
1173
  * The published definition to connect to. Give it, or `values`, not both.
@@ -1101,11 +1469,18 @@ export interface ZoConnectionDefinitionPublishOutputV1 {
1101
1469
  visibility: string;
1102
1470
  }
1103
1471
  export interface ZoDatabaseCreateInputV1 {
1472
+ /**
1473
+ * @maxItems 100
1474
+ *
1475
+ * Items: A tag ID or name; unknown names are created, unknown IDs are refused.
1476
+ */
1477
+ tags?: string[];
1104
1478
  workspace_id: string;
1105
1479
  /**
1106
- * Required but ignored: a retried create can make a second database.
1480
+ * @deprecated
1481
+ * Ignored compatibility field. Omit it; supplying a key does not deduplicate this operation.
1107
1482
  */
1108
- idempotency_key: string;
1483
+ idempotency_key?: (string | null);
1109
1484
  display_name: string;
1110
1485
  /**
1111
1486
  * What the database holds. Members and their agents choose a database from `zo.database.list` by it.
@@ -1813,6 +2188,12 @@ export interface ZoDatabaseUpdateOutputV1DatabaseStorage {
1813
2188
  * ``subject_type`` is the resource type an occurrence's ``subject`` names.
1814
2189
  */
1815
2190
  export interface ZoEventCreateInputV1 {
2191
+ /**
2192
+ * @maxItems 100
2193
+ *
2194
+ * Items: A tag ID or name; unknown names are created, unknown IDs are refused.
2195
+ */
2196
+ tags?: string[];
1816
2197
  workspace_id: string;
1817
2198
  publisher: string;
1818
2199
  name: string;
@@ -1865,6 +2246,12 @@ export interface ZoEventCreateOutputV1EventProperties {
1865
2246
  * to, which ``per_conversation`` Agent subscriptions key sessions by.
1866
2247
  */
1867
2248
  export interface ZoEventCreateInputV2 {
2249
+ /**
2250
+ * @maxItems 100
2251
+ *
2252
+ * Items: A tag ID or name; unknown names are created, unknown IDs are refused.
2253
+ */
2254
+ tags?: string[];
1868
2255
  workspace_id: string;
1869
2256
  publisher: string;
1870
2257
  name: string;
@@ -2467,6 +2854,34 @@ export interface ZoFunctionPublishContractOutputV1 {
2467
2854
  contract_version: number;
2468
2855
  digest: string;
2469
2856
  }
2857
+ /**
2858
+ * Omitted fields keep their value.
2859
+ */
2860
+ export interface ZoFunctionUpdateInputV1 {
2861
+ function_id: string;
2862
+ expected_revision: number;
2863
+ display_name?: (string | null);
2864
+ /**
2865
+ * "" clears the description.
2866
+ */
2867
+ description?: (string | null);
2868
+ }
2869
+ export interface ZoFunctionUpdateOutputV1 {
2870
+ id: string;
2871
+ workspace_id: string;
2872
+ type: "function";
2873
+ type_version: number;
2874
+ display_name: string;
2875
+ description: string;
2876
+ revision: number;
2877
+ properties: ZoFunctionUpdateOutputV1FunctionProperties;
2878
+ active_deployment_id: (string | null);
2879
+ visibility: ("workspace" | "protected");
2880
+ owner_user_id: (string | null);
2881
+ }
2882
+ export interface ZoFunctionUpdateOutputV1FunctionProperties {
2883
+ code_owner: ("zo" | "workspace");
2884
+ }
2470
2885
  export interface ZoMachineApplyPatchInputV1 {
2471
2886
  machine_id: string;
2472
2887
  path: string;
@@ -2490,8 +2905,18 @@ export interface ZoMachineApplyPatchOutputV1 {
2490
2905
  }
2491
2906
  export type ZoMachineCreateInputV1GpuType = ("T4" | "L4" | "A10" | "L40S" | "A100" | "A100-40GB" | "A100-80GB" | "RTX-PRO-6000" | "H100" | "H100!" | "H200" | "B200" | "B200+" | "B300");
2492
2907
  export interface ZoMachineCreateInputV1 {
2908
+ /**
2909
+ * @maxItems 100
2910
+ *
2911
+ * Items: A tag ID or name; unknown names are created, unknown IDs are refused.
2912
+ */
2913
+ tags?: string[];
2493
2914
  workspace_id: string;
2494
- idempotency_key: string;
2915
+ /**
2916
+ * @deprecated
2917
+ * Ignored compatibility field. Omit it; supplying a key does not deduplicate this operation.
2918
+ */
2919
+ idempotency_key?: (string | null);
2495
2920
  display_name: string;
2496
2921
  /**
2497
2922
  * Describe what this machine is for in the user's terms.
@@ -2521,6 +2946,12 @@ export interface ZoMachineCreateInputV1 {
2521
2946
  * @maxItems 100
2522
2947
  */
2523
2948
  credentials?: string[];
2949
+ /**
2950
+ * Header rules: on HTTPS requests from the machine to a rule's hosts, Zo sets a header built from a connection's credential, and the credential never enters the machine. A rule names the connection (`credential`) and one of its definition's slots (`slot`). With only those two, it uses the hosts, header and format the slot declares in its `injections`. It may give its own `hosts`, `location` and `format`, all three together, only for a slot that declares an `environment_variable`. Formats: `bearer` (`Bearer <value>`), `basic` with a `username` (`Basic` with base64 of `<username>:<value>`) and `raw` (the value as stored). A rule sets its header only while the machine holds a use grant on the connection. Two rules can't set the same header on the same host, and all rules together set at most 25 header values. Requests to a host with a rule use HTTP/1.1.
2951
+ *
2952
+ * @maxItems 25
2953
+ */
2954
+ outbound_network_policies?: ZoMachineCreateInputV1OutboundNetworkPolicy[];
2524
2955
  /**
2525
2956
  * `workspace` (default): every member can see and use it. `protected`: only you, and whoever you share it with; workspace-wide grants don't reach it. Fixed at creation.
2526
2957
  */
@@ -2551,6 +2982,48 @@ export interface ZoMachineCreateInputV1MachineLifecycleInput {
2551
2982
  idle_timeout_seconds?: (number | null);
2552
2983
  max_run_seconds: number;
2553
2984
  }
2985
+ /**
2986
+ * Send one slot's credential as a header on HTTPS requests to some hosts.
2987
+ */
2988
+ export interface ZoMachineCreateInputV1OutboundNetworkPolicy {
2989
+ /**
2990
+ * The connection ID.
2991
+ */
2992
+ credential: string;
2993
+ /**
2994
+ * The connection definition's slot, by name.
2995
+ */
2996
+ slot: string;
2997
+ hosts?: ([string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | null);
2998
+ location?: (ZoMachineCreateInputV1HeaderLocation | null);
2999
+ format?: ((ZoMachineCreateInputV1BearerFormat | ZoMachineCreateInputV1BasicFormat | ZoMachineCreateInputV1RawFormat) | null);
3000
+ }
3001
+ export interface ZoMachineCreateInputV1HeaderLocation {
3002
+ type: "header";
3003
+ /**
3004
+ * The header to set, such as `Authorization` or `X-API-Key`.
3005
+ */
3006
+ name: string;
3007
+ }
3008
+ export interface ZoMachineCreateInputV1BearerFormat {
3009
+ /**
3010
+ * `Bearer <value>`.
3011
+ */
3012
+ type: "bearer";
3013
+ }
3014
+ export interface ZoMachineCreateInputV1BasicFormat {
3015
+ /**
3016
+ * `Basic` with base64 of `<username>:<value>`.
3017
+ */
3018
+ type: "basic";
3019
+ username: string;
3020
+ }
3021
+ export interface ZoMachineCreateInputV1RawFormat {
3022
+ /**
3023
+ * The value as it is.
3024
+ */
3025
+ type: "raw";
3026
+ }
2554
3027
  export type ZoMachineCreateOutputV1GpuType = ("T4" | "L4" | "A10" | "L40S" | "A100" | "A100-40GB" | "A100-80GB" | "RTX-PRO-6000" | "H100" | "H100!" | "H200" | "B200" | "B200+" | "B300");
2555
3028
  export type ZoMachineCreateOutputV1ObservedState = ("creating" | "running" | "stopping" | "stopped" | "resuming" | "destroying" | "destroyed" | "failed");
2556
3029
  /**
@@ -2604,11 +3077,54 @@ export interface ZoMachineCreateOutputV1MachineProperties {
2604
3077
  [k: string]: string;
2605
3078
  } | null);
2606
3079
  credentials?: (string[] | null);
3080
+ outbound_network_policies?: (ZoMachineCreateOutputV1OutboundNetworkPolicy[] | null);
2607
3081
  }
2608
3082
  export interface ZoMachineCreateOutputV1MachineGpu {
2609
3083
  type: ZoMachineCreateOutputV1GpuType;
2610
3084
  count: number;
2611
3085
  }
3086
+ /**
3087
+ * Send one slot's credential as a header on HTTPS requests to some hosts.
3088
+ */
3089
+ export interface ZoMachineCreateOutputV1OutboundNetworkPolicy {
3090
+ /**
3091
+ * The connection ID.
3092
+ */
3093
+ credential: string;
3094
+ /**
3095
+ * The connection definition's slot, by name.
3096
+ */
3097
+ slot: string;
3098
+ hosts?: ([string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | null);
3099
+ location?: (ZoMachineCreateOutputV1HeaderLocation | null);
3100
+ format?: ((ZoMachineCreateOutputV1BearerFormat | ZoMachineCreateOutputV1BasicFormat | ZoMachineCreateOutputV1RawFormat) | null);
3101
+ }
3102
+ export interface ZoMachineCreateOutputV1HeaderLocation {
3103
+ type: "header";
3104
+ /**
3105
+ * The header to set, such as `Authorization` or `X-API-Key`.
3106
+ */
3107
+ name: string;
3108
+ }
3109
+ export interface ZoMachineCreateOutputV1BearerFormat {
3110
+ /**
3111
+ * `Bearer <value>`.
3112
+ */
3113
+ type: "bearer";
3114
+ }
3115
+ export interface ZoMachineCreateOutputV1BasicFormat {
3116
+ /**
3117
+ * `Basic` with base64 of `<username>:<value>`.
3118
+ */
3119
+ type: "basic";
3120
+ username: string;
3121
+ }
3122
+ export interface ZoMachineCreateOutputV1RawFormat {
3123
+ /**
3124
+ * The value as it is.
3125
+ */
3126
+ type: "raw";
3127
+ }
2612
3128
  export interface ZoMachineCreateOutputV1MachineBootedView {
2613
3129
  init: ("none" | "image");
2614
3130
  command: (string[] | null);
@@ -2616,7 +3132,11 @@ export interface ZoMachineCreateOutputV1MachineBootedView {
2616
3132
  export interface ZoMachineDestroyInputV1 {
2617
3133
  machine_id: string;
2618
3134
  expected_revision: number;
2619
- idempotency_key: string;
3135
+ /**
3136
+ * @deprecated
3137
+ * Ignored compatibility field. Omit it; supplying a key does not deduplicate this operation.
3138
+ */
3139
+ idempotency_key?: (string | null);
2620
3140
  }
2621
3141
  export type ZoMachineDestroyOutputV1GpuType = ("T4" | "L4" | "A10" | "L40S" | "A100" | "A100-40GB" | "A100-80GB" | "RTX-PRO-6000" | "H100" | "H100!" | "H200" | "B200" | "B200+" | "B300");
2622
3142
  export type ZoMachineDestroyOutputV1ObservedState = ("creating" | "running" | "stopping" | "stopped" | "resuming" | "destroying" | "destroyed" | "failed");
@@ -2671,11 +3191,54 @@ export interface ZoMachineDestroyOutputV1MachineProperties {
2671
3191
  [k: string]: string;
2672
3192
  } | null);
2673
3193
  credentials?: (string[] | null);
3194
+ outbound_network_policies?: (ZoMachineDestroyOutputV1OutboundNetworkPolicy[] | null);
2674
3195
  }
2675
3196
  export interface ZoMachineDestroyOutputV1MachineGpu {
2676
3197
  type: ZoMachineDestroyOutputV1GpuType;
2677
3198
  count: number;
2678
3199
  }
3200
+ /**
3201
+ * Send one slot's credential as a header on HTTPS requests to some hosts.
3202
+ */
3203
+ export interface ZoMachineDestroyOutputV1OutboundNetworkPolicy {
3204
+ /**
3205
+ * The connection ID.
3206
+ */
3207
+ credential: string;
3208
+ /**
3209
+ * The connection definition's slot, by name.
3210
+ */
3211
+ slot: string;
3212
+ hosts?: ([string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | null);
3213
+ location?: (ZoMachineDestroyOutputV1HeaderLocation | null);
3214
+ format?: ((ZoMachineDestroyOutputV1BearerFormat | ZoMachineDestroyOutputV1BasicFormat | ZoMachineDestroyOutputV1RawFormat) | null);
3215
+ }
3216
+ export interface ZoMachineDestroyOutputV1HeaderLocation {
3217
+ type: "header";
3218
+ /**
3219
+ * The header to set, such as `Authorization` or `X-API-Key`.
3220
+ */
3221
+ name: string;
3222
+ }
3223
+ export interface ZoMachineDestroyOutputV1BearerFormat {
3224
+ /**
3225
+ * `Bearer <value>`.
3226
+ */
3227
+ type: "bearer";
3228
+ }
3229
+ export interface ZoMachineDestroyOutputV1BasicFormat {
3230
+ /**
3231
+ * `Basic` with base64 of `<username>:<value>`.
3232
+ */
3233
+ type: "basic";
3234
+ username: string;
3235
+ }
3236
+ export interface ZoMachineDestroyOutputV1RawFormat {
3237
+ /**
3238
+ * The value as it is.
3239
+ */
3240
+ type: "raw";
3241
+ }
2679
3242
  export interface ZoMachineDestroyOutputV1MachineBootedView {
2680
3243
  init: ("none" | "image");
2681
3244
  command: (string[] | null);
@@ -2751,11 +3314,54 @@ export interface ZoMachineGetOutputV1MachineProperties {
2751
3314
  [k: string]: string;
2752
3315
  } | null);
2753
3316
  credentials?: (string[] | null);
3317
+ outbound_network_policies?: (ZoMachineGetOutputV1OutboundNetworkPolicy[] | null);
2754
3318
  }
2755
3319
  export interface ZoMachineGetOutputV1MachineGpu {
2756
3320
  type: ZoMachineGetOutputV1GpuType;
2757
3321
  count: number;
2758
3322
  }
3323
+ /**
3324
+ * Send one slot's credential as a header on HTTPS requests to some hosts.
3325
+ */
3326
+ export interface ZoMachineGetOutputV1OutboundNetworkPolicy {
3327
+ /**
3328
+ * The connection ID.
3329
+ */
3330
+ credential: string;
3331
+ /**
3332
+ * The connection definition's slot, by name.
3333
+ */
3334
+ slot: string;
3335
+ hosts?: ([string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | null);
3336
+ location?: (ZoMachineGetOutputV1HeaderLocation | null);
3337
+ format?: ((ZoMachineGetOutputV1BearerFormat | ZoMachineGetOutputV1BasicFormat | ZoMachineGetOutputV1RawFormat) | null);
3338
+ }
3339
+ export interface ZoMachineGetOutputV1HeaderLocation {
3340
+ type: "header";
3341
+ /**
3342
+ * The header to set, such as `Authorization` or `X-API-Key`.
3343
+ */
3344
+ name: string;
3345
+ }
3346
+ export interface ZoMachineGetOutputV1BearerFormat {
3347
+ /**
3348
+ * `Bearer <value>`.
3349
+ */
3350
+ type: "bearer";
3351
+ }
3352
+ export interface ZoMachineGetOutputV1BasicFormat {
3353
+ /**
3354
+ * `Basic` with base64 of `<username>:<value>`.
3355
+ */
3356
+ type: "basic";
3357
+ username: string;
3358
+ }
3359
+ export interface ZoMachineGetOutputV1RawFormat {
3360
+ /**
3361
+ * The value as it is.
3362
+ */
3363
+ type: "raw";
3364
+ }
2759
3365
  export interface ZoMachineGetOutputV1MachineBootedView {
2760
3366
  init: ("none" | "image");
2761
3367
  command: (string[] | null);
@@ -2820,11 +3426,54 @@ export interface ZoMachineListOutputV1MachineProperties {
2820
3426
  [k: string]: string;
2821
3427
  } | null);
2822
3428
  credentials?: (string[] | null);
3429
+ outbound_network_policies?: (ZoMachineListOutputV1OutboundNetworkPolicy[] | null);
2823
3430
  }
2824
3431
  export interface ZoMachineListOutputV1MachineGpu {
2825
3432
  type: ZoMachineListOutputV1GpuType;
2826
3433
  count: number;
2827
3434
  }
3435
+ /**
3436
+ * Send one slot's credential as a header on HTTPS requests to some hosts.
3437
+ */
3438
+ export interface ZoMachineListOutputV1OutboundNetworkPolicy {
3439
+ /**
3440
+ * The connection ID.
3441
+ */
3442
+ credential: string;
3443
+ /**
3444
+ * The connection definition's slot, by name.
3445
+ */
3446
+ slot: string;
3447
+ hosts?: ([string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | null);
3448
+ location?: (ZoMachineListOutputV1HeaderLocation | null);
3449
+ format?: ((ZoMachineListOutputV1BearerFormat | ZoMachineListOutputV1BasicFormat | ZoMachineListOutputV1RawFormat) | null);
3450
+ }
3451
+ export interface ZoMachineListOutputV1HeaderLocation {
3452
+ type: "header";
3453
+ /**
3454
+ * The header to set, such as `Authorization` or `X-API-Key`.
3455
+ */
3456
+ name: string;
3457
+ }
3458
+ export interface ZoMachineListOutputV1BearerFormat {
3459
+ /**
3460
+ * `Bearer <value>`.
3461
+ */
3462
+ type: "bearer";
3463
+ }
3464
+ export interface ZoMachineListOutputV1BasicFormat {
3465
+ /**
3466
+ * `Basic` with base64 of `<username>:<value>`.
3467
+ */
3468
+ type: "basic";
3469
+ username: string;
3470
+ }
3471
+ export interface ZoMachineListOutputV1RawFormat {
3472
+ /**
3473
+ * The value as it is.
3474
+ */
3475
+ type: "raw";
3476
+ }
2828
3477
  export interface ZoMachineListOutputV1MachineBootedView {
2829
3478
  init: ("none" | "image");
2830
3479
  command: (string[] | null);
@@ -2932,7 +3581,11 @@ export interface ZoMachineReadBytesOutputV1 {
2932
3581
  export interface ZoMachineResumeInputV1 {
2933
3582
  machine_id: string;
2934
3583
  expected_revision: number;
2935
- idempotency_key: string;
3584
+ /**
3585
+ * @deprecated
3586
+ * Ignored compatibility field. Omit it; supplying a key does not deduplicate this operation.
3587
+ */
3588
+ idempotency_key?: (string | null);
2936
3589
  accept_recovery?: boolean;
2937
3590
  }
2938
3591
  export type ZoMachineResumeOutputV1GpuType = ("T4" | "L4" | "A10" | "L40S" | "A100" | "A100-40GB" | "A100-80GB" | "RTX-PRO-6000" | "H100" | "H100!" | "H200" | "B200" | "B200+" | "B300");
@@ -2988,11 +3641,54 @@ export interface ZoMachineResumeOutputV1MachineProperties {
2988
3641
  [k: string]: string;
2989
3642
  } | null);
2990
3643
  credentials?: (string[] | null);
3644
+ outbound_network_policies?: (ZoMachineResumeOutputV1OutboundNetworkPolicy[] | null);
2991
3645
  }
2992
3646
  export interface ZoMachineResumeOutputV1MachineGpu {
2993
3647
  type: ZoMachineResumeOutputV1GpuType;
2994
3648
  count: number;
2995
3649
  }
3650
+ /**
3651
+ * Send one slot's credential as a header on HTTPS requests to some hosts.
3652
+ */
3653
+ export interface ZoMachineResumeOutputV1OutboundNetworkPolicy {
3654
+ /**
3655
+ * The connection ID.
3656
+ */
3657
+ credential: string;
3658
+ /**
3659
+ * The connection definition's slot, by name.
3660
+ */
3661
+ slot: string;
3662
+ hosts?: ([string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | null);
3663
+ location?: (ZoMachineResumeOutputV1HeaderLocation | null);
3664
+ format?: ((ZoMachineResumeOutputV1BearerFormat | ZoMachineResumeOutputV1BasicFormat | ZoMachineResumeOutputV1RawFormat) | null);
3665
+ }
3666
+ export interface ZoMachineResumeOutputV1HeaderLocation {
3667
+ type: "header";
3668
+ /**
3669
+ * The header to set, such as `Authorization` or `X-API-Key`.
3670
+ */
3671
+ name: string;
3672
+ }
3673
+ export interface ZoMachineResumeOutputV1BearerFormat {
3674
+ /**
3675
+ * `Bearer <value>`.
3676
+ */
3677
+ type: "bearer";
3678
+ }
3679
+ export interface ZoMachineResumeOutputV1BasicFormat {
3680
+ /**
3681
+ * `Basic` with base64 of `<username>:<value>`.
3682
+ */
3683
+ type: "basic";
3684
+ username: string;
3685
+ }
3686
+ export interface ZoMachineResumeOutputV1RawFormat {
3687
+ /**
3688
+ * The value as it is.
3689
+ */
3690
+ type: "raw";
3691
+ }
2996
3692
  export interface ZoMachineResumeOutputV1MachineBootedView {
2997
3693
  init: ("none" | "image");
2998
3694
  command: (string[] | null);
@@ -3055,7 +3751,11 @@ export interface ZoMachineSnapshotOutputV1MachineImageProperties {
3055
3751
  export interface ZoMachineStopInputV1 {
3056
3752
  machine_id: string;
3057
3753
  expected_revision: number;
3058
- idempotency_key: string;
3754
+ /**
3755
+ * @deprecated
3756
+ * Ignored compatibility field. Omit it; supplying a key does not deduplicate this operation.
3757
+ */
3758
+ idempotency_key?: (string | null);
3059
3759
  }
3060
3760
  export type ZoMachineStopOutputV1GpuType = ("T4" | "L4" | "A10" | "L40S" | "A100" | "A100-40GB" | "A100-80GB" | "RTX-PRO-6000" | "H100" | "H100!" | "H200" | "B200" | "B200+" | "B300");
3061
3761
  export type ZoMachineStopOutputV1ObservedState = ("creating" | "running" | "stopping" | "stopped" | "resuming" | "destroying" | "destroyed" | "failed");
@@ -3110,11 +3810,54 @@ export interface ZoMachineStopOutputV1MachineProperties {
3110
3810
  [k: string]: string;
3111
3811
  } | null);
3112
3812
  credentials?: (string[] | null);
3813
+ outbound_network_policies?: (ZoMachineStopOutputV1OutboundNetworkPolicy[] | null);
3113
3814
  }
3114
3815
  export interface ZoMachineStopOutputV1MachineGpu {
3115
3816
  type: ZoMachineStopOutputV1GpuType;
3116
3817
  count: number;
3117
3818
  }
3819
+ /**
3820
+ * Send one slot's credential as a header on HTTPS requests to some hosts.
3821
+ */
3822
+ export interface ZoMachineStopOutputV1OutboundNetworkPolicy {
3823
+ /**
3824
+ * The connection ID.
3825
+ */
3826
+ credential: string;
3827
+ /**
3828
+ * The connection definition's slot, by name.
3829
+ */
3830
+ slot: string;
3831
+ hosts?: ([string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | null);
3832
+ location?: (ZoMachineStopOutputV1HeaderLocation | null);
3833
+ format?: ((ZoMachineStopOutputV1BearerFormat | ZoMachineStopOutputV1BasicFormat | ZoMachineStopOutputV1RawFormat) | null);
3834
+ }
3835
+ export interface ZoMachineStopOutputV1HeaderLocation {
3836
+ type: "header";
3837
+ /**
3838
+ * The header to set, such as `Authorization` or `X-API-Key`.
3839
+ */
3840
+ name: string;
3841
+ }
3842
+ export interface ZoMachineStopOutputV1BearerFormat {
3843
+ /**
3844
+ * `Bearer <value>`.
3845
+ */
3846
+ type: "bearer";
3847
+ }
3848
+ export interface ZoMachineStopOutputV1BasicFormat {
3849
+ /**
3850
+ * `Basic` with base64 of `<username>:<value>`.
3851
+ */
3852
+ type: "basic";
3853
+ username: string;
3854
+ }
3855
+ export interface ZoMachineStopOutputV1RawFormat {
3856
+ /**
3857
+ * The value as it is.
3858
+ */
3859
+ type: "raw";
3860
+ }
3118
3861
  export interface ZoMachineStopOutputV1MachineBootedView {
3119
3862
  init: ("none" | "image");
3120
3863
  command: (string[] | null);
@@ -3239,6 +3982,10 @@ export interface ZoMachineUpdateInputV1 {
3239
3982
  * The list that replaces the stored one; omit it to keep it. Connection IDs whose credentials the machine receives as environment variables, in the boot process and every command. Each slot of a listed connection sets the variable its definition names, with the variables the slot and the connection declare. The machine also needs a use grant on each connection (`zo.grant.create` with the machine as assignee); a listed connection without one delivers nothing. When two listed connections set the same variable, the later one in the list wins. At most 100 connections, each listed once.
3240
3983
  */
3241
3984
  credentials?: (string[] | null);
3985
+ /**
3986
+ * The rules that replace the stored ones; omit them to keep them. A running machine's requests use the new rules once the update returns. Header rules: on HTTPS requests from the machine to a rule's hosts, Zo sets a header built from a connection's credential, and the credential never enters the machine. A rule names the connection (`credential`) and one of its definition's slots (`slot`). With only those two, it uses the hosts, header and format the slot declares in its `injections`. It may give its own `hosts`, `location` and `format`, all three together, only for a slot that declares an `environment_variable`. Formats: `bearer` (`Bearer <value>`), `basic` with a `username` (`Basic` with base64 of `<username>:<value>`) and `raw` (the value as stored). A rule sets its header only while the machine holds a use grant on the connection. Two rules can't set the same header on the same host, and all rules together set at most 25 header values. Requests to a host with a rule use HTTP/1.1.
3987
+ */
3988
+ outbound_network_policies?: (ZoMachineUpdateInputV1OutboundNetworkPolicy[] | null);
3242
3989
  }
3243
3990
  /**
3244
3991
  * The timers a caller may change after create. Modal fixes them at
@@ -3248,6 +3995,48 @@ export interface ZoMachineUpdateInputV1MachineLifecycleUpdate {
3248
3995
  idle_timeout_seconds?: (number | null);
3249
3996
  max_run_seconds?: (number | null);
3250
3997
  }
3998
+ /**
3999
+ * Send one slot's credential as a header on HTTPS requests to some hosts.
4000
+ */
4001
+ export interface ZoMachineUpdateInputV1OutboundNetworkPolicy {
4002
+ /**
4003
+ * The connection ID.
4004
+ */
4005
+ credential: string;
4006
+ /**
4007
+ * The connection definition's slot, by name.
4008
+ */
4009
+ slot: string;
4010
+ hosts?: ([string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | null);
4011
+ location?: (ZoMachineUpdateInputV1HeaderLocation | null);
4012
+ format?: ((ZoMachineUpdateInputV1BearerFormat | ZoMachineUpdateInputV1BasicFormat | ZoMachineUpdateInputV1RawFormat) | null);
4013
+ }
4014
+ export interface ZoMachineUpdateInputV1HeaderLocation {
4015
+ type: "header";
4016
+ /**
4017
+ * The header to set, such as `Authorization` or `X-API-Key`.
4018
+ */
4019
+ name: string;
4020
+ }
4021
+ export interface ZoMachineUpdateInputV1BearerFormat {
4022
+ /**
4023
+ * `Bearer <value>`.
4024
+ */
4025
+ type: "bearer";
4026
+ }
4027
+ export interface ZoMachineUpdateInputV1BasicFormat {
4028
+ /**
4029
+ * `Basic` with base64 of `<username>:<value>`.
4030
+ */
4031
+ type: "basic";
4032
+ username: string;
4033
+ }
4034
+ export interface ZoMachineUpdateInputV1RawFormat {
4035
+ /**
4036
+ * The value as it is.
4037
+ */
4038
+ type: "raw";
4039
+ }
3251
4040
  export interface ZoMachineUpdateOutputV1 {
3252
4041
  machine_id: string;
3253
4042
  revision: number;
@@ -3271,7 +4060,11 @@ export interface ZoMachineWriteBytesOutputV1 {
3271
4060
  export interface ZoMachineImageDeleteInputV1 {
3272
4061
  machine_image_id: string;
3273
4062
  expected_revision: number;
3274
- idempotency_key: string;
4063
+ /**
4064
+ * @deprecated
4065
+ * Ignored compatibility field. Omit it; supplying a key does not deduplicate this operation.
4066
+ */
4067
+ idempotency_key?: (string | null);
3275
4068
  }
3276
4069
  export type ZoMachineImageDeleteOutputV1ImageOrigin = ("registry" | "build" | "machine_snapshot");
3277
4070
  export type ZoMachineImageDeleteOutputV1ImageStatus = ("pending" | "preparing" | "ready" | "failed" | "deleting" | "deleted");
@@ -3357,7 +4150,11 @@ export interface ZoMachineImageImportInputV1 {
3357
4150
  */
3358
4151
  visibility?: ("workspace" | "protected");
3359
4152
  workspace_id: string;
3360
- idempotency_key: string;
4153
+ /**
4154
+ * @deprecated
4155
+ * Ignored compatibility field. Omit it; supplying a key does not deduplicate this operation.
4156
+ */
4157
+ idempotency_key?: (string | null);
3361
4158
  source: ZoMachineImageImportInputV1RegistrySourceInput;
3362
4159
  }
3363
4160
  export interface ZoMachineImageImportInputV1RegistrySourceInput {
@@ -3403,18 +4200,73 @@ export interface ZoMachineImageImportOutputV1MachineImageProperties {
3403
4200
  export interface ZoMachineImageListInputV1 {
3404
4201
  workspace_id: string;
3405
4202
  }
3406
- export type ZoMachineImageListOutputV1ImageOrigin = ("registry" | "build" | "machine_snapshot");
3407
- export type ZoMachineImageListOutputV1ImageStatus = ("pending" | "preparing" | "ready" | "failed" | "deleting" | "deleted");
3408
- export interface ZoMachineImageListOutputV1 {
3409
- machine_images: ZoMachineImageListOutputV1MachineImageView[];
3410
- next_cursor?: (string | null);
4203
+ export type ZoMachineImageListOutputV1ImageOrigin = ("registry" | "build" | "machine_snapshot");
4204
+ export type ZoMachineImageListOutputV1ImageStatus = ("pending" | "preparing" | "ready" | "failed" | "deleting" | "deleted");
4205
+ export interface ZoMachineImageListOutputV1 {
4206
+ machine_images: ZoMachineImageListOutputV1MachineImageView[];
4207
+ next_cursor?: (string | null);
4208
+ }
4209
+ /**
4210
+ * A `machine_image` resource with its preparation status. ``source_digest``
4211
+ * is the pinned manifest digest once resolved; ``error_code`` is set only for
4212
+ * an image that failed.
4213
+ */
4214
+ export interface ZoMachineImageListOutputV1MachineImageView {
4215
+ id: string;
4216
+ workspace_id: string;
4217
+ type: "machine_image";
4218
+ type_version: number;
4219
+ display_name: string;
4220
+ description: string;
4221
+ visibility: ("workspace" | "protected");
4222
+ revision: number;
4223
+ properties: ZoMachineImageListOutputV1MachineImageProperties;
4224
+ status: ZoMachineImageListOutputV1ImageStatus;
4225
+ source_digest: (string | null);
4226
+ error_code: (string | null);
4227
+ created_at: string;
4228
+ ready_at: (string | null);
4229
+ deleted_at: (string | null);
4230
+ }
4231
+ /**
4232
+ * Public properties of a `machine_image` resource, type version 1: what
4233
+ * the image is, fixed when it was admitted. Status and the resolved digest
4234
+ * live on the ``machine_images`` row, not in the registry.
4235
+ */
4236
+ export interface ZoMachineImageListOutputV1MachineImageProperties {
4237
+ origin: ZoMachineImageListOutputV1ImageOrigin;
4238
+ artifact_format: ("oci" | "provider_filesystem_snapshot");
4239
+ architecture: ("amd64" | "arm64");
4240
+ source_ref: (string | null);
4241
+ }
4242
+ export interface ZoMachineImageListQueryV1 {
4243
+ /**
4244
+ * Rows per page, at most 200; a larger value is reduced to it.
4245
+ */
4246
+ limit?: number;
4247
+ /**
4248
+ * The previous page's next_cursor, sent with the same sort, filter and search.
4249
+ */
4250
+ cursor?: string;
4251
+ sort?: ("id.asc" | "created_at.desc" | "created_at.asc" | "display_name.asc");
4252
+ }
4253
+ export interface ZoMachineImageUpdateInputV1 {
4254
+ machine_image_id: string;
4255
+ expected_revision: number;
4256
+ display_name?: (string | null);
4257
+ /**
4258
+ * "" clears the description.
4259
+ */
4260
+ description?: (string | null);
3411
4261
  }
4262
+ export type ZoMachineImageUpdateOutputV1ImageOrigin = ("registry" | "build" | "machine_snapshot");
4263
+ export type ZoMachineImageUpdateOutputV1ImageStatus = ("pending" | "preparing" | "ready" | "failed" | "deleting" | "deleted");
3412
4264
  /**
3413
4265
  * A `machine_image` resource with its preparation status. ``source_digest``
3414
4266
  * is the pinned manifest digest once resolved; ``error_code`` is set only for
3415
4267
  * an image that failed.
3416
4268
  */
3417
- export interface ZoMachineImageListOutputV1MachineImageView {
4269
+ export interface ZoMachineImageUpdateOutputV1 {
3418
4270
  id: string;
3419
4271
  workspace_id: string;
3420
4272
  type: "machine_image";
@@ -3423,8 +4275,8 @@ export interface ZoMachineImageListOutputV1MachineImageView {
3423
4275
  description: string;
3424
4276
  visibility: ("workspace" | "protected");
3425
4277
  revision: number;
3426
- properties: ZoMachineImageListOutputV1MachineImageProperties;
3427
- status: ZoMachineImageListOutputV1ImageStatus;
4278
+ properties: ZoMachineImageUpdateOutputV1MachineImageProperties;
4279
+ status: ZoMachineImageUpdateOutputV1ImageStatus;
3428
4280
  source_digest: (string | null);
3429
4281
  error_code: (string | null);
3430
4282
  created_at: string;
@@ -3436,23 +4288,12 @@ export interface ZoMachineImageListOutputV1MachineImageView {
3436
4288
  * the image is, fixed when it was admitted. Status and the resolved digest
3437
4289
  * live on the ``machine_images`` row, not in the registry.
3438
4290
  */
3439
- export interface ZoMachineImageListOutputV1MachineImageProperties {
3440
- origin: ZoMachineImageListOutputV1ImageOrigin;
4291
+ export interface ZoMachineImageUpdateOutputV1MachineImageProperties {
4292
+ origin: ZoMachineImageUpdateOutputV1ImageOrigin;
3441
4293
  artifact_format: ("oci" | "provider_filesystem_snapshot");
3442
4294
  architecture: ("amd64" | "arm64");
3443
4295
  source_ref: (string | null);
3444
4296
  }
3445
- export interface ZoMachineImageListQueryV1 {
3446
- /**
3447
- * Rows per page, at most 200; a larger value is reduced to it.
3448
- */
3449
- limit?: number;
3450
- /**
3451
- * The previous page's next_cursor, sent with the same sort, filter and search.
3452
- */
3453
- cursor?: string;
3454
- sort?: ("id.asc" | "created_at.desc" | "created_at.asc" | "display_name.asc");
3455
- }
3456
4297
  export interface ZoMessageGetInputV1 {
3457
4298
  /**
3458
4299
  * The Agent that sent or received the message.
@@ -3520,6 +4361,14 @@ export interface ZoMessageGetOutputV1MessageDelivery {
3520
4361
  */
3521
4362
  outcome: (("completed" | "cancelled" | "interrupted" | "failed") | null);
3522
4363
  outcome_reason: (string | null);
4364
+ /**
4365
+ * The model the message was admitted with: the one it named, else the session's.
4366
+ */
4367
+ model: (string | null);
4368
+ /**
4369
+ * The reasoning level the message was admitted with; null for the model's default.
4370
+ */
4371
+ reasoning: (string | null);
3523
4372
  }
3524
4373
  export interface ZoOauthAppCreateInputV1 {
3525
4374
  workspace_id: string;
@@ -3658,7 +4507,174 @@ export interface ZoOauthAppUpdateOutputV1 {
3658
4507
  connection_id: (string | null);
3659
4508
  state: string;
3660
4509
  }
4510
+ export interface ZoQuotaGetInputV1 {
4511
+ workspace_id: string;
4512
+ /**
4513
+ * Public quota definitions:
4514
+ * database.count: Databases not yet deleted, including creation and deletion in progress. Kind: capacity; scope: workspace; unit: database; measurement: databases_not_deleted.
4515
+ * database.storage_per_database: Desired storage ceiling for each database; a provider update may still be pending. Kind: per_resource_bound; scope: resource (database); unit: byte; measurement: not_applicable.
4516
+ * knowledge.storage: Stored and reserved Knowledge bytes. Kind: capacity; scope: workspace; unit: byte; measurement: stored_bytes_plus_reserved_bytes.
4517
+ * machine.allocated_gpus: GPU count in unreleased compute allocations, including pending starts. Kind: capacity; scope: workspace; unit: gpu; measurement: unreleased_allocations_including_pending_starts.
4518
+ * machine.allocated_machines: Unreleased machine compute allocations, including pending starts. Kind: capacity; scope: workspace; unit: machine; measurement: unreleased_allocations_including_pending_starts.
4519
+ * machine.allocated_memory: Memory in unreleased compute allocations, including pending starts. Kind: capacity; scope: workspace; unit: MiB; measurement: unreleased_allocations_including_pending_starts.
4520
+ * machine.allocated_vcpus: vCPUs in unreleased compute allocations, including pending starts. Kind: capacity; scope: workspace; unit: vcpu; measurement: unreleased_allocations_including_pending_starts.
4521
+ * machine.concurrent_image_builds: Image builds in pending or preparing states. Kind: capacity; scope: workspace; unit: build; measurement: pending_and_preparing_images.
4522
+ * machine.image_builds_24h: Registry and build-origin images created in the trailing 86400 seconds. Kind: windowed; scope: workspace; unit: build; measurement: registry_and_build_images_created_in_trailing_86400_seconds.
4523
+ * machine.image_lineage_depth: Maximum lineage depth of one machine image. Kind: per_resource_bound; scope: resource (machine_image); unit: level; measurement: not_applicable.
4524
+ * machine.memory_per_machine: Maximum memory allocated to one machine. Kind: per_resource_bound; scope: resource (machine); unit: MiB; measurement: not_applicable.
4525
+ * machine.period_spend: Billed and proven unbilled machine compute in the workspace billing period; this allowance is not available credit. Kind: windowed; scope: workspace; unit: USD; measurement: billed_and_proven_unbilled_compute_in_billing_period.
4526
+ * machine.retained_images: Images not yet deleted, including unfinished images. Kind: capacity; scope: workspace; unit: image; measurement: images_not_deleted.
4527
+ * machine.retained_storage: Latest retained root and volume storage measurements under admission retention rules. Kind: capacity; scope: workspace; unit: byte; measurement: latest_retained_root_and_volume_measurements.
4528
+ * machine.vcpus_per_machine: Maximum vCPUs allocated to one machine. Kind: per_resource_bound; scope: resource (machine); unit: vcpu; measurement: not_applicable.
4529
+ * workspace.members: Memberships and live invitations occupying admission slots. Kind: capacity; scope: workspace; unit: member; measurement: memberships_and_live_invitations.
4530
+ */
4531
+ quota_key: ("database.count" | "database.storage_per_database" | "knowledge.storage" | "machine.allocated_gpus" | "machine.allocated_machines" | "machine.allocated_memory" | "machine.allocated_vcpus" | "machine.concurrent_image_builds" | "machine.image_builds_24h" | "machine.image_lineage_depth" | "machine.memory_per_machine" | "machine.period_spend" | "machine.retained_images" | "machine.retained_storage" | "machine.vcpus_per_machine" | "workspace.members");
4532
+ }
4533
+ export interface ZoQuotaGetOutputV1 {
4534
+ workspace_id: string;
4535
+ /**
4536
+ * Public quota definitions:
4537
+ * database.count: Databases not yet deleted, including creation and deletion in progress. Kind: capacity; scope: workspace; unit: database; measurement: databases_not_deleted.
4538
+ * database.storage_per_database: Desired storage ceiling for each database; a provider update may still be pending. Kind: per_resource_bound; scope: resource (database); unit: byte; measurement: not_applicable.
4539
+ * knowledge.storage: Stored and reserved Knowledge bytes. Kind: capacity; scope: workspace; unit: byte; measurement: stored_bytes_plus_reserved_bytes.
4540
+ * machine.allocated_gpus: GPU count in unreleased compute allocations, including pending starts. Kind: capacity; scope: workspace; unit: gpu; measurement: unreleased_allocations_including_pending_starts.
4541
+ * machine.allocated_machines: Unreleased machine compute allocations, including pending starts. Kind: capacity; scope: workspace; unit: machine; measurement: unreleased_allocations_including_pending_starts.
4542
+ * machine.allocated_memory: Memory in unreleased compute allocations, including pending starts. Kind: capacity; scope: workspace; unit: MiB; measurement: unreleased_allocations_including_pending_starts.
4543
+ * machine.allocated_vcpus: vCPUs in unreleased compute allocations, including pending starts. Kind: capacity; scope: workspace; unit: vcpu; measurement: unreleased_allocations_including_pending_starts.
4544
+ * machine.concurrent_image_builds: Image builds in pending or preparing states. Kind: capacity; scope: workspace; unit: build; measurement: pending_and_preparing_images.
4545
+ * machine.image_builds_24h: Registry and build-origin images created in the trailing 86400 seconds. Kind: windowed; scope: workspace; unit: build; measurement: registry_and_build_images_created_in_trailing_86400_seconds.
4546
+ * machine.image_lineage_depth: Maximum lineage depth of one machine image. Kind: per_resource_bound; scope: resource (machine_image); unit: level; measurement: not_applicable.
4547
+ * machine.memory_per_machine: Maximum memory allocated to one machine. Kind: per_resource_bound; scope: resource (machine); unit: MiB; measurement: not_applicable.
4548
+ * machine.period_spend: Billed and proven unbilled machine compute in the workspace billing period; this allowance is not available credit. Kind: windowed; scope: workspace; unit: USD; measurement: billed_and_proven_unbilled_compute_in_billing_period.
4549
+ * machine.retained_images: Images not yet deleted, including unfinished images. Kind: capacity; scope: workspace; unit: image; measurement: images_not_deleted.
4550
+ * machine.retained_storage: Latest retained root and volume storage measurements under admission retention rules. Kind: capacity; scope: workspace; unit: byte; measurement: latest_retained_root_and_volume_measurements.
4551
+ * machine.vcpus_per_machine: Maximum vCPUs allocated to one machine. Kind: per_resource_bound; scope: resource (machine); unit: vcpu; measurement: not_applicable.
4552
+ * workspace.members: Memberships and live invitations occupying admission slots. Kind: capacity; scope: workspace; unit: member; measurement: memberships_and_live_invitations.
4553
+ */
4554
+ quota_key: ("database.count" | "database.storage_per_database" | "knowledge.storage" | "machine.allocated_gpus" | "machine.allocated_machines" | "machine.allocated_memory" | "machine.allocated_vcpus" | "machine.concurrent_image_builds" | "machine.image_builds_24h" | "machine.image_lineage_depth" | "machine.memory_per_machine" | "machine.period_spend" | "machine.retained_images" | "machine.retained_storage" | "machine.vcpus_per_machine" | "workspace.members");
4555
+ description: string;
4556
+ kind: ("capacity" | "windowed" | "per_resource_bound");
4557
+ scope: ZoQuotaGetOutputV1QuotaScope;
4558
+ unit: string;
4559
+ limit: ZoQuotaGetOutputV1QuotaLimit;
4560
+ measurement: ZoQuotaGetOutputV1QuotaMeasurement;
4561
+ headroom: ZoQuotaGetOutputV1QuotaRemainder;
4562
+ overage: ZoQuotaGetOutputV1QuotaRemainder;
4563
+ }
4564
+ export interface ZoQuotaGetOutputV1QuotaScope {
4565
+ kind: ("workspace" | "resource");
4566
+ resource_type?: (string | null);
4567
+ }
4568
+ export interface ZoQuotaGetOutputV1QuotaLimit {
4569
+ kind: ("finite" | "unlimited" | "not_configured" | "unavailable");
4570
+ amount?: (string | null);
4571
+ }
4572
+ export interface ZoQuotaGetOutputV1QuotaMeasurement {
4573
+ status: ("available" | "unavailable" | "not_configured" | "not_applicable");
4574
+ amount?: (string | null);
4575
+ observed_at?: (string | null);
4576
+ basis?: (string | null);
4577
+ used?: (string | null);
4578
+ reserved?: (string | null);
4579
+ window?: (ZoQuotaGetOutputV1QuotaWindow | null);
4580
+ }
4581
+ export interface ZoQuotaGetOutputV1QuotaWindow {
4582
+ start: string;
4583
+ end: string;
4584
+ rule: ("trailing_86400_seconds" | "billing_period");
4585
+ }
4586
+ export interface ZoQuotaGetOutputV1QuotaRemainder {
4587
+ status: ("available" | "unknown" | "unlimited" | "not_configured" | "not_applicable");
4588
+ amount?: (string | null);
4589
+ }
4590
+ export interface ZoQuotaListInputV1 {
4591
+ workspace_id: string;
4592
+ }
4593
+ export interface ZoQuotaListOutputV1 {
4594
+ quotas: ZoQuotaListOutputV1QuotaReading[];
4595
+ next_cursor?: (string | null);
4596
+ observed_at: string;
4597
+ }
4598
+ export interface ZoQuotaListOutputV1QuotaReading {
4599
+ workspace_id: string;
4600
+ /**
4601
+ * Public quota definitions:
4602
+ * database.count: Databases not yet deleted, including creation and deletion in progress. Kind: capacity; scope: workspace; unit: database; measurement: databases_not_deleted.
4603
+ * database.storage_per_database: Desired storage ceiling for each database; a provider update may still be pending. Kind: per_resource_bound; scope: resource (database); unit: byte; measurement: not_applicable.
4604
+ * knowledge.storage: Stored and reserved Knowledge bytes. Kind: capacity; scope: workspace; unit: byte; measurement: stored_bytes_plus_reserved_bytes.
4605
+ * machine.allocated_gpus: GPU count in unreleased compute allocations, including pending starts. Kind: capacity; scope: workspace; unit: gpu; measurement: unreleased_allocations_including_pending_starts.
4606
+ * machine.allocated_machines: Unreleased machine compute allocations, including pending starts. Kind: capacity; scope: workspace; unit: machine; measurement: unreleased_allocations_including_pending_starts.
4607
+ * machine.allocated_memory: Memory in unreleased compute allocations, including pending starts. Kind: capacity; scope: workspace; unit: MiB; measurement: unreleased_allocations_including_pending_starts.
4608
+ * machine.allocated_vcpus: vCPUs in unreleased compute allocations, including pending starts. Kind: capacity; scope: workspace; unit: vcpu; measurement: unreleased_allocations_including_pending_starts.
4609
+ * machine.concurrent_image_builds: Image builds in pending or preparing states. Kind: capacity; scope: workspace; unit: build; measurement: pending_and_preparing_images.
4610
+ * machine.image_builds_24h: Registry and build-origin images created in the trailing 86400 seconds. Kind: windowed; scope: workspace; unit: build; measurement: registry_and_build_images_created_in_trailing_86400_seconds.
4611
+ * machine.image_lineage_depth: Maximum lineage depth of one machine image. Kind: per_resource_bound; scope: resource (machine_image); unit: level; measurement: not_applicable.
4612
+ * machine.memory_per_machine: Maximum memory allocated to one machine. Kind: per_resource_bound; scope: resource (machine); unit: MiB; measurement: not_applicable.
4613
+ * machine.period_spend: Billed and proven unbilled machine compute in the workspace billing period; this allowance is not available credit. Kind: windowed; scope: workspace; unit: USD; measurement: billed_and_proven_unbilled_compute_in_billing_period.
4614
+ * machine.retained_images: Images not yet deleted, including unfinished images. Kind: capacity; scope: workspace; unit: image; measurement: images_not_deleted.
4615
+ * machine.retained_storage: Latest retained root and volume storage measurements under admission retention rules. Kind: capacity; scope: workspace; unit: byte; measurement: latest_retained_root_and_volume_measurements.
4616
+ * machine.vcpus_per_machine: Maximum vCPUs allocated to one machine. Kind: per_resource_bound; scope: resource (machine); unit: vcpu; measurement: not_applicable.
4617
+ * workspace.members: Memberships and live invitations occupying admission slots. Kind: capacity; scope: workspace; unit: member; measurement: memberships_and_live_invitations.
4618
+ */
4619
+ quota_key: ("database.count" | "database.storage_per_database" | "knowledge.storage" | "machine.allocated_gpus" | "machine.allocated_machines" | "machine.allocated_memory" | "machine.allocated_vcpus" | "machine.concurrent_image_builds" | "machine.image_builds_24h" | "machine.image_lineage_depth" | "machine.memory_per_machine" | "machine.period_spend" | "machine.retained_images" | "machine.retained_storage" | "machine.vcpus_per_machine" | "workspace.members");
4620
+ description: string;
4621
+ kind: ("capacity" | "windowed" | "per_resource_bound");
4622
+ scope: ZoQuotaListOutputV1QuotaScope;
4623
+ unit: string;
4624
+ limit: ZoQuotaListOutputV1QuotaLimit;
4625
+ measurement: ZoQuotaListOutputV1QuotaMeasurement;
4626
+ headroom: ZoQuotaListOutputV1QuotaRemainder;
4627
+ overage: ZoQuotaListOutputV1QuotaRemainder;
4628
+ }
4629
+ export interface ZoQuotaListOutputV1QuotaScope {
4630
+ kind: ("workspace" | "resource");
4631
+ resource_type?: (string | null);
4632
+ }
4633
+ export interface ZoQuotaListOutputV1QuotaLimit {
4634
+ kind: ("finite" | "unlimited" | "not_configured" | "unavailable");
4635
+ amount?: (string | null);
4636
+ }
4637
+ export interface ZoQuotaListOutputV1QuotaMeasurement {
4638
+ status: ("available" | "unavailable" | "not_configured" | "not_applicable");
4639
+ amount?: (string | null);
4640
+ observed_at?: (string | null);
4641
+ basis?: (string | null);
4642
+ used?: (string | null);
4643
+ reserved?: (string | null);
4644
+ window?: (ZoQuotaListOutputV1QuotaWindow | null);
4645
+ }
4646
+ export interface ZoQuotaListOutputV1QuotaWindow {
4647
+ start: string;
4648
+ end: string;
4649
+ rule: ("trailing_86400_seconds" | "billing_period");
4650
+ }
4651
+ export interface ZoQuotaListOutputV1QuotaRemainder {
4652
+ status: ("available" | "unknown" | "unlimited" | "not_configured" | "not_applicable");
4653
+ amount?: (string | null);
4654
+ }
4655
+ export interface ZoQuotaListQueryV1 {
4656
+ /**
4657
+ * Rows per page, at most 100; a larger value is reduced to it.
4658
+ */
4659
+ limit?: number;
4660
+ /**
4661
+ * The previous page's next_cursor, sent with the same sort, filter and search.
4662
+ */
4663
+ cursor?: string;
4664
+ sort?: ("quota_key.asc" | "quota_key.desc");
4665
+ filter?: {
4666
+ kind?: (("capacity" | "windowed" | "per_resource_bound") | null);
4667
+ scope?: (("workspace" | "resource") | null);
4668
+ resource_type?: (("machine" | "machine_image" | "database") | null);
4669
+ };
4670
+ }
3661
4671
  export interface ZoScheduleCreateInputV1 {
4672
+ /**
4673
+ * @maxItems 100
4674
+ *
4675
+ * Items: A tag ID or name; unknown names are created, unknown IDs are refused.
4676
+ */
4677
+ tags?: string[];
3662
4678
  workspace_id: string;
3663
4679
  display_name: string;
3664
4680
  /**
@@ -3871,6 +4887,12 @@ export type ZoSubscriptionCreateInputV1InputContractKind = ("exact_event" | "gen
3871
4887
  * account the handler runs as. Omit ``filter`` to receive every occurrence.
3872
4888
  */
3873
4889
  export interface ZoSubscriptionCreateInputV1 {
4890
+ /**
4891
+ * @maxItems 100
4892
+ *
4893
+ * Items: A tag ID or name; unknown names are created, unknown IDs are refused.
4894
+ */
4895
+ tags?: string[];
3874
4896
  workspace_id: string;
3875
4897
  event_id: string;
3876
4898
  display_name: string;
@@ -4074,6 +5096,12 @@ export type ZoSubscriptionCreateInputV2InputContractKind = ("exact_event" | "gen
4074
5096
  * occurrence.
4075
5097
  */
4076
5098
  export interface ZoSubscriptionCreateInputV2 {
5099
+ /**
5100
+ * @maxItems 100
5101
+ *
5102
+ * Items: A tag ID or name; unknown names are created, unknown IDs are refused.
5103
+ */
5104
+ tags?: string[];
4077
5105
  workspace_id: string;
4078
5106
  event_id: string;
4079
5107
  display_name: string;
@@ -4712,7 +5740,7 @@ export interface ZoSubscriptionListOutputV1PrincipalRef {
4712
5740
  }
4713
5741
  export interface ZoSubscriptionListQueryV1 {
4714
5742
  /**
4715
- * Rows per page, at most 7; a larger value is reduced to it.
5743
+ * Rows per page, at most 100; a larger value is reduced to it.
4716
5744
  */
4717
5745
  limit?: number;
4718
5746
  /**
@@ -4869,7 +5897,7 @@ export interface ZoSubscriptionListOutputV2PrincipalRef {
4869
5897
  }
4870
5898
  export interface ZoSubscriptionListQueryV2 {
4871
5899
  /**
4872
- * Rows per page, at most 7; a larger value is reduced to it.
5900
+ * Rows per page, at most 100; a larger value is reduced to it.
4873
5901
  */
4874
5902
  limit?: number;
4875
5903
  /**
@@ -5309,7 +6337,12 @@ export interface ZoSubscriptionUpdateOutputV2PrincipalRef {
5309
6337
  }
5310
6338
  export interface ZoTagAssignInputV1 {
5311
6339
  workspace_id: string;
5312
- target: ZoTagAssignInputV1TargetRef;
6340
+ target?: ZoTagAssignInputV1TargetRef;
6341
+ /**
6342
+ * @minItems 1
6343
+ * @maxItems 200
6344
+ */
6345
+ targets?: [ZoTagAssignInputV1TargetRef, ...(ZoTagAssignInputV1TargetRef)[]];
5313
6346
  /**
5314
6347
  * Tags by ID or name.
5315
6348
  *
@@ -5322,7 +6355,7 @@ export interface ZoTagAssignInputV1 {
5322
6355
  }
5323
6356
  export interface ZoTagAssignInputV1TargetRef {
5324
6357
  /**
5325
- * The object's kind: task, agent, schedule, website, connection, event, event_subscription, machine, database or file.
6358
+ * The object's kind: task, agent, schedule, website, connection, event, event_subscription, machine, database, function, workflow, machine_image, vault or file.
5326
6359
  */
5327
6360
  kind: string;
5328
6361
  /**
@@ -5331,15 +6364,19 @@ export interface ZoTagAssignInputV1TargetRef {
5331
6364
  id: string;
5332
6365
  }
5333
6366
  export interface ZoTagAssignOutputV1 {
5334
- target: ZoTagAssignOutputV1TargetRef;
5335
6367
  /**
5336
- * The object's tags, alphabetically.
6368
+ * @minItems 1
6369
+ * @maxItems 200
5337
6370
  */
5338
- tags: ZoTagAssignOutputV1TagView[];
6371
+ objects: [ZoTagAssignOutputV1ObjectChanges, ...(ZoTagAssignOutputV1ObjectChanges)[]];
6372
+ }
6373
+ export interface ZoTagAssignOutputV1ObjectChanges {
6374
+ target: ZoTagAssignOutputV1TargetRef;
6375
+ changed: number;
5339
6376
  }
5340
6377
  export interface ZoTagAssignOutputV1TargetRef {
5341
6378
  /**
5342
- * The object's kind: task, agent, schedule, website, connection, event, event_subscription, machine, database or file.
6379
+ * The object's kind: task, agent, schedule, website, connection, event, event_subscription, machine, database, function, workflow, machine_image, vault or file.
5343
6380
  */
5344
6381
  kind: string;
5345
6382
  /**
@@ -5347,13 +6384,6 @@ export interface ZoTagAssignOutputV1TargetRef {
5347
6384
  */
5348
6385
  id: string;
5349
6386
  }
5350
- export interface ZoTagAssignOutputV1TagView {
5351
- id: string;
5352
- /**
5353
- * The tag's name, spelled as first written.
5354
- */
5355
- name: string;
5356
- }
5357
6387
  export interface ZoTagDeleteInputV1 {
5358
6388
  workspace_id: string;
5359
6389
  /**
@@ -5406,7 +6436,7 @@ export interface ZoTagItemsQueryV1 {
5406
6436
  cursor?: string;
5407
6437
  filter?: {
5408
6438
  /**
5409
- * Only objects of these kinds (task, agent, schedule, website, connection, event, event_subscription, machine, database or file).
6439
+ * Only objects of these kinds (task, agent, schedule, website, connection, event, event_subscription, machine, database, function, workflow, machine_image, vault or file).
5410
6440
  */
5411
6441
  kinds?: ([string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | null);
5412
6442
  };
@@ -5454,7 +6484,7 @@ export interface ZoTagOfInputV1 {
5454
6484
  }
5455
6485
  export interface ZoTagOfInputV1TargetRef {
5456
6486
  /**
5457
- * The object's kind: task, agent, schedule, website, connection, event, event_subscription, machine, database or file.
6487
+ * The object's kind: task, agent, schedule, website, connection, event, event_subscription, machine, database, function, workflow, machine_image, vault or file.
5458
6488
  */
5459
6489
  kind: string;
5460
6490
  /**
@@ -5477,7 +6507,7 @@ export interface ZoTagOfOutputV1ObjectTags {
5477
6507
  }
5478
6508
  export interface ZoTagOfOutputV1TargetRef {
5479
6509
  /**
5480
- * The object's kind: task, agent, schedule, website, connection, event, event_subscription, machine, database or file.
6510
+ * The object's kind: task, agent, schedule, website, connection, event, event_subscription, machine, database, function, workflow, machine_image, vault or file.
5481
6511
  */
5482
6512
  kind: string;
5483
6513
  /**
@@ -5512,7 +6542,12 @@ export interface ZoTagRenameOutputV1 {
5512
6542
  }
5513
6543
  export interface ZoTagUnassignInputV1 {
5514
6544
  workspace_id: string;
5515
- target: ZoTagUnassignInputV1TargetRef;
6545
+ target?: ZoTagUnassignInputV1TargetRef;
6546
+ /**
6547
+ * @minItems 1
6548
+ * @maxItems 200
6549
+ */
6550
+ targets?: [ZoTagUnassignInputV1TargetRef, ...(ZoTagUnassignInputV1TargetRef)[]];
5516
6551
  /**
5517
6552
  * Tags by ID or name.
5518
6553
  *
@@ -5525,7 +6560,7 @@ export interface ZoTagUnassignInputV1 {
5525
6560
  }
5526
6561
  export interface ZoTagUnassignInputV1TargetRef {
5527
6562
  /**
5528
- * The object's kind: task, agent, schedule, website, connection, event, event_subscription, machine, database or file.
6563
+ * The object's kind: task, agent, schedule, website, connection, event, event_subscription, machine, database, function, workflow, machine_image, vault or file.
5529
6564
  */
5530
6565
  kind: string;
5531
6566
  /**
@@ -5534,15 +6569,19 @@ export interface ZoTagUnassignInputV1TargetRef {
5534
6569
  id: string;
5535
6570
  }
5536
6571
  export interface ZoTagUnassignOutputV1 {
5537
- target: ZoTagUnassignOutputV1TargetRef;
5538
6572
  /**
5539
- * The object's tags, alphabetically.
6573
+ * @minItems 1
6574
+ * @maxItems 200
5540
6575
  */
5541
- tags: ZoTagUnassignOutputV1TagView[];
6576
+ objects: [ZoTagUnassignOutputV1ObjectChanges, ...(ZoTagUnassignOutputV1ObjectChanges)[]];
6577
+ }
6578
+ export interface ZoTagUnassignOutputV1ObjectChanges {
6579
+ target: ZoTagUnassignOutputV1TargetRef;
6580
+ changed: number;
5542
6581
  }
5543
6582
  export interface ZoTagUnassignOutputV1TargetRef {
5544
6583
  /**
5545
- * The object's kind: task, agent, schedule, website, connection, event, event_subscription, machine, database or file.
6584
+ * The object's kind: task, agent, schedule, website, connection, event, event_subscription, machine, database, function, workflow, machine_image, vault or file.
5546
6585
  */
5547
6586
  kind: string;
5548
6587
  /**
@@ -5550,13 +6589,6 @@ export interface ZoTagUnassignOutputV1TargetRef {
5550
6589
  */
5551
6590
  id: string;
5552
6591
  }
5553
- export interface ZoTagUnassignOutputV1TagView {
5554
- id: string;
5555
- /**
5556
- * The tag's name, spelled as first written.
5557
- */
5558
- name: string;
5559
- }
5560
6592
  export interface ZoTaskBlockerAddInputV1 {
5561
6593
  workspace_id: string;
5562
6594
  /**
@@ -5572,6 +6604,7 @@ export interface ZoTaskBlockerAddOutputV1 {
5572
6604
  id: string;
5573
6605
  workspace_id: string;
5574
6606
  number: number;
6607
+ title: string;
5575
6608
  status: ("backlog" | "ready" | "in_progress" | "failed" | "done" | "cancelled");
5576
6609
  assignee: (ZoTaskBlockerAddOutputV1PrincipalView | null);
5577
6610
  /**
@@ -5640,6 +6673,7 @@ export interface ZoTaskBlockerAddOutputV1PrincipalView {
5640
6673
  export interface ZoTaskBlockerAddOutputV1TaskLink {
5641
6674
  id: string;
5642
6675
  number: number;
6676
+ title: string;
5643
6677
  status: ("backlog" | "ready" | "in_progress" | "failed" | "done" | "cancelled");
5644
6678
  }
5645
6679
  export interface ZoTaskBlockerAddOutputV1TaskComment {
@@ -5678,6 +6712,7 @@ export interface ZoTaskBlockerRemoveOutputV1 {
5678
6712
  id: string;
5679
6713
  workspace_id: string;
5680
6714
  number: number;
6715
+ title: string;
5681
6716
  status: ("backlog" | "ready" | "in_progress" | "failed" | "done" | "cancelled");
5682
6717
  assignee: (ZoTaskBlockerRemoveOutputV1PrincipalView | null);
5683
6718
  /**
@@ -5746,6 +6781,7 @@ export interface ZoTaskBlockerRemoveOutputV1PrincipalView {
5746
6781
  export interface ZoTaskBlockerRemoveOutputV1TaskLink {
5747
6782
  id: string;
5748
6783
  number: number;
6784
+ title: string;
5749
6785
  status: ("backlog" | "ready" | "in_progress" | "failed" | "done" | "cancelled");
5750
6786
  }
5751
6787
  export interface ZoTaskBlockerRemoveOutputV1TaskComment {
@@ -5936,7 +6972,14 @@ export interface ZoTaskCommentUpdateOutputV1PrincipalView {
5936
6972
  active: boolean;
5937
6973
  }
5938
6974
  export interface ZoTaskCreateInputV1 {
6975
+ /**
6976
+ * @maxItems 100
6977
+ *
6978
+ * Items: A tag ID or name; unknown names are created, unknown IDs are refused.
6979
+ */
6980
+ tags?: string[];
5939
6981
  workspace_id: string;
6982
+ title: string;
5940
6983
  body?: string;
5941
6984
  status?: ("backlog" | "ready" | "in_progress" | "failed" | "done" | "cancelled");
5942
6985
  assignee?: (ZoTaskCreateInputV1PrincipalInput | null);
@@ -5953,6 +6996,7 @@ export interface ZoTaskCreateOutputV1 {
5953
6996
  id: string;
5954
6997
  workspace_id: string;
5955
6998
  number: number;
6999
+ title: string;
5956
7000
  status: ("backlog" | "ready" | "in_progress" | "failed" | "done" | "cancelled");
5957
7001
  assignee: (ZoTaskCreateOutputV1PrincipalView | null);
5958
7002
  /**
@@ -6021,6 +7065,7 @@ export interface ZoTaskCreateOutputV1PrincipalView {
6021
7065
  export interface ZoTaskCreateOutputV1TaskLink {
6022
7066
  id: string;
6023
7067
  number: number;
7068
+ title: string;
6024
7069
  status: ("backlog" | "ready" | "in_progress" | "failed" | "done" | "cancelled");
6025
7070
  }
6026
7071
  export interface ZoTaskCreateOutputV1TaskComment {
@@ -6066,6 +7111,7 @@ export interface ZoTaskGetOutputV1 {
6066
7111
  id: string;
6067
7112
  workspace_id: string;
6068
7113
  number: number;
7114
+ title: string;
6069
7115
  status: ("backlog" | "ready" | "in_progress" | "failed" | "done" | "cancelled");
6070
7116
  assignee: (ZoTaskGetOutputV1PrincipalView | null);
6071
7117
  /**
@@ -6134,6 +7180,7 @@ export interface ZoTaskGetOutputV1PrincipalView {
6134
7180
  export interface ZoTaskGetOutputV1TaskLink {
6135
7181
  id: string;
6136
7182
  number: number;
7183
+ title: string;
6137
7184
  status: ("backlog" | "ready" | "in_progress" | "failed" | "done" | "cancelled");
6138
7185
  }
6139
7186
  export interface ZoTaskGetOutputV1TaskComment {
@@ -6172,6 +7219,7 @@ export interface ZoTaskListOutputV1TaskSummary {
6172
7219
  id: string;
6173
7220
  workspace_id: string;
6174
7221
  number: number;
7222
+ title: string;
6175
7223
  status: ("backlog" | "ready" | "in_progress" | "failed" | "done" | "cancelled");
6176
7224
  assignee: (ZoTaskListOutputV1PrincipalView | null);
6177
7225
  /**
@@ -6222,6 +7270,10 @@ export interface ZoTaskListQueryV1 {
6222
7270
  * Only blocked tasks, or only unblocked ones.
6223
7271
  */
6224
7272
  is_blocked?: (boolean | null);
7273
+ /**
7274
+ * Tasks carrying any of these workspace tag IDs.
7275
+ */
7276
+ tags?: (string[] | null);
6225
7277
  };
6226
7278
  }
6227
7279
  /**
@@ -6240,6 +7292,7 @@ export interface ZoTaskUpdateInputV1 {
6240
7292
  * The task's number ("42" or "#42") or its tsk_ ID.
6241
7293
  */
6242
7294
  task: string;
7295
+ title?: (string | null);
6243
7296
  body?: (string | null);
6244
7297
  status?: (("backlog" | "ready" | "in_progress" | "failed" | "done" | "cancelled") | null);
6245
7298
  /**
@@ -6263,6 +7316,7 @@ export interface ZoTaskUpdateOutputV1 {
6263
7316
  id: string;
6264
7317
  workspace_id: string;
6265
7318
  number: number;
7319
+ title: string;
6266
7320
  status: ("backlog" | "ready" | "in_progress" | "failed" | "done" | "cancelled");
6267
7321
  assignee: (ZoTaskUpdateOutputV1PrincipalView | null);
6268
7322
  /**
@@ -6331,6 +7385,7 @@ export interface ZoTaskUpdateOutputV1PrincipalView {
6331
7385
  export interface ZoTaskUpdateOutputV1TaskLink {
6332
7386
  id: string;
6333
7387
  number: number;
7388
+ title: string;
6334
7389
  status: ("backlog" | "ready" | "in_progress" | "failed" | "done" | "cancelled");
6335
7390
  }
6336
7391
  export interface ZoTaskUpdateOutputV1TaskComment {
@@ -6841,7 +7896,143 @@ export interface ZoVaultUpdateOutputV1RawFormat {
6841
7896
  */
6842
7897
  type: "raw";
6843
7898
  }
7899
+ export interface ZoWebFetchInputV1 {
7900
+ workspace_id: string;
7901
+ /**
7902
+ * The pages to read. A URL listed twice is read and charged once and returned at each position.
7903
+ *
7904
+ * @minItems 1
7905
+ * @maxItems 100
7906
+ *
7907
+ * Items: An http or https URL.
7908
+ */
7909
+ urls: [string, ...(string)[]];
7910
+ /**
7911
+ * The most text to return per page. The response size limit can shorten pages further; a shortened page is marked truncated.
7912
+ */
7913
+ max_characters?: number;
7914
+ /**
7915
+ * Fetch each page now instead of using a cached copy. Use it for prices, status pages and anything else that changes by the hour.
7916
+ */
7917
+ live?: boolean;
7918
+ }
7919
+ export interface ZoWebFetchOutputV1 {
7920
+ /**
7921
+ * One entry per requested URL, in the order requested. A page that couldn't be read has status failed; the call still succeeds.
7922
+ */
7923
+ pages: (ZoWebFetchOutputV1WebPage | ZoWebFetchOutputV1WebPageFailure)[];
7924
+ }
7925
+ export interface ZoWebFetchOutputV1WebPage {
7926
+ /**
7927
+ * The URL as requested.
7928
+ */
7929
+ url: string;
7930
+ status: "ok";
7931
+ title: (string | null);
7932
+ /**
7933
+ * The page's estimated publication date, YYYY-MM-DD.
7934
+ */
7935
+ published_date: (string | null);
7936
+ author: (string | null);
7937
+ /**
7938
+ * The page's main content as Markdown.
7939
+ */
7940
+ text: string;
7941
+ /**
7942
+ * Whether the page had more text than was returned.
7943
+ */
7944
+ truncated: boolean;
7945
+ }
7946
+ export interface ZoWebFetchOutputV1WebPageFailure {
7947
+ /**
7948
+ * The URL as requested.
7949
+ */
7950
+ url: string;
7951
+ status: "failed";
7952
+ /**
7953
+ * not_found: the page doesn't exist. blocked: the site refused access. timeout: the page took too long to load. unsupported: the URL can't be read. unavailable: anything else; trying again later may work.
7954
+ */
7955
+ error: ("not_found" | "blocked" | "timeout" | "unsupported" | "unavailable");
7956
+ }
7957
+ export interface ZoWebSearchInputV1 {
7958
+ workspace_id: string;
7959
+ /**
7960
+ * Describe the pages you want, as a sentence, rather than keywords. Restrict sites with include_domains, not site: in the query.
7961
+ */
7962
+ query: string;
7963
+ /**
7964
+ * Goal for this search turn; say which documents should rank first, which should be excluded, and what specific facts or figures to pull from them.
7965
+ */
7966
+ objective?: (string | null);
7967
+ /**
7968
+ * Focus on one kind of page. Omit for the general web. company and people can't take published dates; people can't take exclude_domains.
7969
+ */
7970
+ category?: (("news" | "company" | "people" | "financial_report" | "publication" | "personal_site") | null);
7971
+ /**
7972
+ * How many results to return.
7973
+ */
7974
+ num_results?: number;
7975
+ /**
7976
+ * Only return pages from these domains.
7977
+ */
7978
+ include_domains?: (string[] | null);
7979
+ /**
7980
+ * Never return pages from these domains.
7981
+ */
7982
+ exclude_domains?: (string[] | null);
7983
+ /**
7984
+ * Only pages published on or after the start of this day, UTC.
7985
+ */
7986
+ published_after?: (string | null);
7987
+ /**
7988
+ * Only pages published before the start of this day, UTC.
7989
+ */
7990
+ published_before?: (string | null);
7991
+ }
7992
+ export interface ZoWebSearchOutputV1 {
7993
+ /**
7994
+ * Ranked pages, best first.
7995
+ */
7996
+ results: ZoWebSearchOutputV1WebSearchHit[];
7997
+ /**
7998
+ * Notes on how the results were produced, such as a restriction in the query that was relaxed because it matched nothing. Omitted when there are none.
7999
+ */
8000
+ notices?: (ZoWebSearchOutputV1WebNotice[] | null);
8001
+ }
8002
+ export interface ZoWebSearchOutputV1WebSearchHit {
8003
+ url: string;
8004
+ title: (string | null);
8005
+ /**
8006
+ * The page's estimated publication date, YYYY-MM-DD.
8007
+ */
8008
+ published_date: (string | null);
8009
+ author: (string | null);
8010
+ /**
8011
+ * The passages most relevant to the query.
8012
+ */
8013
+ highlights: string[];
8014
+ }
8015
+ export interface ZoWebSearchOutputV1WebNotice {
8016
+ /**
8017
+ * An open set of codes, such as RESTRICTIONS_RELAXED.
8018
+ */
8019
+ code: string;
8020
+ /**
8021
+ * What the notice means, written for a model reading the results.
8022
+ */
8023
+ message: string;
8024
+ /**
8025
+ * The input field the notice is about, as a JSON Pointer.
8026
+ */
8027
+ path?: (string | null);
8028
+ }
6844
8029
  export interface ZoWebsiteCreateInputV1 {
8030
+ /**
8031
+ * @maxItems 100
8032
+ *
8033
+ * Items: A tag ID or name; unknown names are created, unknown IDs are refused.
8034
+ */
8035
+ tags?: string[];
6845
8036
  workspace_id: string;
6846
8037
  slug: string;
6847
8038
  display_name: string;
@@ -7519,6 +8710,29 @@ export interface ZoWorkflowRevisionGetOutputV1 {
7519
8710
  status: ZoWorkflowRevisionGetOutputV1RevisionStatus;
7520
8711
  error_code: (string | null);
7521
8712
  }
8713
+ export interface ZoWorkflowUpdateInputV1 {
8714
+ workflow_id: string;
8715
+ expected_revision: number;
8716
+ display_name?: (string | null);
8717
+ /**
8718
+ * Omitted or null keeps the description; "" clears it.
8719
+ */
8720
+ description?: (string | null);
8721
+ }
8722
+ export interface ZoWorkflowUpdateOutputV1 {
8723
+ id: string;
8724
+ workspace_id: string;
8725
+ type: "workflow";
8726
+ type_version: number;
8727
+ display_name: string;
8728
+ description: string;
8729
+ revision: number;
8730
+ active_revision_id: (string | null);
8731
+ latest_revision_id: (string | null);
8732
+ created_at: string;
8733
+ visibility: ("workspace" | "protected");
8734
+ owner_user_id: (string | null);
8735
+ }
7522
8736
  export interface ZoWorkspaceGetInputV1 {
7523
8737
  workspace_id: string;
7524
8738
  }
@@ -7644,11 +8858,54 @@ export interface MachineV1 {
7644
8858
  [k: string]: string;
7645
8859
  } | null);
7646
8860
  credentials?: (string[] | null);
8861
+ outbound_network_policies?: (MachineV1OutboundNetworkPolicy[] | null);
7647
8862
  }
7648
8863
  export interface MachineV1MachineGpu {
7649
8864
  type: MachineV1GpuType;
7650
8865
  count: number;
7651
8866
  }
8867
+ /**
8868
+ * Send one slot's credential as a header on HTTPS requests to some hosts.
8869
+ */
8870
+ export interface MachineV1OutboundNetworkPolicy {
8871
+ /**
8872
+ * The connection ID.
8873
+ */
8874
+ credential: string;
8875
+ /**
8876
+ * The connection definition's slot, by name.
8877
+ */
8878
+ slot: string;
8879
+ hosts?: ([string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | null);
8880
+ location?: (MachineV1HeaderLocation | null);
8881
+ format?: ((MachineV1BearerFormat | MachineV1BasicFormat | MachineV1RawFormat) | null);
8882
+ }
8883
+ export interface MachineV1HeaderLocation {
8884
+ type: "header";
8885
+ /**
8886
+ * The header to set, such as `Authorization` or `X-API-Key`.
8887
+ */
8888
+ name: string;
8889
+ }
8890
+ export interface MachineV1BearerFormat {
8891
+ /**
8892
+ * `Bearer <value>`.
8893
+ */
8894
+ type: "bearer";
8895
+ }
8896
+ export interface MachineV1BasicFormat {
8897
+ /**
8898
+ * `Basic` with base64 of `<username>:<value>`.
8899
+ */
8900
+ type: "basic";
8901
+ username: string;
8902
+ }
8903
+ export interface MachineV1RawFormat {
8904
+ /**
8905
+ * The value as it is.
8906
+ */
8907
+ type: "raw";
8908
+ }
7652
8909
  export type MachineImageV1ImageOrigin = ("registry" | "build" | "machine_snapshot");
7653
8910
  /**
7654
8911
  * Public properties of a `machine_image` resource, type version 1: what
@@ -7781,6 +9038,27 @@ export type Operations = {
7781
9038
  query: ZoAgentSessionListWorkspaceQueryV1;
7782
9039
  };
7783
9040
  };
9041
+ "zo.billing.list_rates": {
9042
+ 1: {
9043
+ input: ZoBillingListRatesInputV1;
9044
+ output: ZoBillingListRatesOutputV1;
9045
+ query: ZoBillingListRatesQueryV1;
9046
+ };
9047
+ };
9048
+ "zo.billing.list_usage_entries": {
9049
+ 1: {
9050
+ input: ZoBillingListUsageEntriesInputV1;
9051
+ output: ZoBillingListUsageEntriesOutputV1;
9052
+ query: ZoBillingListUsageEntriesQueryV1;
9053
+ };
9054
+ };
9055
+ "zo.billing.summarize_usage": {
9056
+ 1: {
9057
+ input: ZoBillingSummarizeUsageInputV1;
9058
+ output: ZoBillingSummarizeUsageOutputV1;
9059
+ query: ZoBillingSummarizeUsageQueryV1;
9060
+ };
9061
+ };
7784
9062
  "zo.connection.authorize": {
7785
9063
  1: {
7786
9064
  input: ZoConnectionAuthorizeInputV1;
@@ -8035,6 +9313,12 @@ export type Operations = {
8035
9313
  output: ZoFunctionPublishContractOutputV1;
8036
9314
  };
8037
9315
  };
9316
+ "zo.function.update": {
9317
+ 1: {
9318
+ input: ZoFunctionUpdateInputV1;
9319
+ output: ZoFunctionUpdateOutputV1;
9320
+ };
9321
+ };
8038
9322
  "zo.machine.apply_patch": {
8039
9323
  1: {
8040
9324
  input: ZoMachineApplyPatchInputV1;
@@ -8152,6 +9436,12 @@ export type Operations = {
8152
9436
  query: ZoMachineImageListQueryV1;
8153
9437
  };
8154
9438
  };
9439
+ "zo.machine_image.update": {
9440
+ 1: {
9441
+ input: ZoMachineImageUpdateInputV1;
9442
+ output: ZoMachineImageUpdateOutputV1;
9443
+ };
9444
+ };
8155
9445
  "zo.message.get": {
8156
9446
  1: {
8157
9447
  input: ZoMessageGetInputV1;
@@ -8189,6 +9479,19 @@ export type Operations = {
8189
9479
  output: ZoOauthAppUpdateOutputV1;
8190
9480
  };
8191
9481
  };
9482
+ "zo.quota.get": {
9483
+ 1: {
9484
+ input: ZoQuotaGetInputV1;
9485
+ output: ZoQuotaGetOutputV1;
9486
+ };
9487
+ };
9488
+ "zo.quota.list": {
9489
+ 1: {
9490
+ input: ZoQuotaListInputV1;
9491
+ output: ZoQuotaListOutputV1;
9492
+ query: ZoQuotaListQueryV1;
9493
+ };
9494
+ };
8192
9495
  "zo.schedule.create": {
8193
9496
  1: {
8194
9497
  input: ZoScheduleCreateInputV1;
@@ -8435,6 +9738,18 @@ export type Operations = {
8435
9738
  output: ZoVaultUpdateOutputV1;
8436
9739
  };
8437
9740
  };
9741
+ "zo.web.fetch": {
9742
+ 1: {
9743
+ input: ZoWebFetchInputV1;
9744
+ output: ZoWebFetchOutputV1;
9745
+ };
9746
+ };
9747
+ "zo.web.search": {
9748
+ 1: {
9749
+ input: ZoWebSearchInputV1;
9750
+ output: ZoWebSearchOutputV1;
9751
+ };
9752
+ };
8438
9753
  "zo.website.create": {
8439
9754
  1: {
8440
9755
  input: ZoWebsiteCreateInputV1;
@@ -8577,6 +9892,12 @@ export type Operations = {
8577
9892
  output: ZoWorkflowRevisionGetOutputV1;
8578
9893
  };
8579
9894
  };
9895
+ "zo.workflow.update": {
9896
+ 1: {
9897
+ input: ZoWorkflowUpdateInputV1;
9898
+ output: ZoWorkflowUpdateOutputV1;
9899
+ };
9900
+ };
8580
9901
  "zo.workspace.get": {
8581
9902
  1: {
8582
9903
  input: ZoWorkspaceGetInputV1;
@@ -8605,6 +9926,9 @@ export type DefaultVersions = {
8605
9926
  "zo.agent_session.history": 1;
8606
9927
  "zo.agent_session.list": 1;
8607
9928
  "zo.agent_session.list_workspace": 1;
9929
+ "zo.billing.list_rates": 1;
9930
+ "zo.billing.list_usage_entries": 1;
9931
+ "zo.billing.summarize_usage": 1;
8608
9932
  "zo.connection.authorize": 1;
8609
9933
  "zo.connection.create": 1;
8610
9934
  "zo.connection.delete": 1;
@@ -8645,6 +9969,7 @@ export type DefaultVersions = {
8645
9969
  "zo.function.list": 1;
8646
9970
  "zo.function.list_runs": 1;
8647
9971
  "zo.function.publish_contract": 1;
9972
+ "zo.function.update": 1;
8648
9973
  "zo.machine.apply_patch": 1;
8649
9974
  "zo.machine.create": 1;
8650
9975
  "zo.machine.destroy": 1;
@@ -8664,12 +9989,15 @@ export type DefaultVersions = {
8664
9989
  "zo.machine_image.get": 1;
8665
9990
  "zo.machine_image.import": 1;
8666
9991
  "zo.machine_image.list": 1;
9992
+ "zo.machine_image.update": 1;
8667
9993
  "zo.message.get": 1;
8668
9994
  "zo.oauth_app.create": 1;
8669
9995
  "zo.oauth_app.delete": 1;
8670
9996
  "zo.oauth_app.get": 1;
8671
9997
  "zo.oauth_app.list": 1;
8672
9998
  "zo.oauth_app.update": 1;
9999
+ "zo.quota.get": 1;
10000
+ "zo.quota.list": 1;
8673
10001
  "zo.schedule.create": 1;
8674
10002
  "zo.schedule.delete": 1;
8675
10003
  "zo.schedule.get": 1;
@@ -8707,6 +10035,8 @@ export type DefaultVersions = {
8707
10035
  "zo.vault.list": 1;
8708
10036
  "zo.vault.rotate": 1;
8709
10037
  "zo.vault.update": 1;
10038
+ "zo.web.fetch": 1;
10039
+ "zo.web.search": 1;
8710
10040
  "zo.website.create": 1;
8711
10041
  "zo.website.delete": 1;
8712
10042
  "zo.website.get": 1;
@@ -8730,6 +10060,7 @@ export type DefaultVersions = {
8730
10060
  "zo.workflow.list_runs": 1;
8731
10061
  "zo.workflow.publish": 1;
8732
10062
  "zo.workflow.revision.get": 1;
10063
+ "zo.workflow.update": 1;
8733
10064
  "zo.workspace.get": 1;
8734
10065
  "zo.workspace.list_resources": 1;
8735
10066
  };