@cloudflare/workers-types 5.20260925.2 → 5.20260926.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -6508,8 +6508,13 @@ export type WebSearchOptions = {
6508
6508
  search_context_size?: "low" | "medium" | "high";
6509
6509
  user_location?: WebSearchUserLocation;
6510
6510
  };
6511
+ // Source of truth for per-model reasoning types: each model's `reasoning_effort` metadata
6512
+ // in Workers AI ConfigAPI (supported efforts, aliases, defaults, and whether reasoning can
6513
+ // be turned off). The Workers AI SDK type generator (cloudflare/ai/sdk,
6514
+ // apps/worker-constellation-entry/scripts/build-types) turns it into the per-model
6515
+ // `inputs` types below; the developer docs model schemas come from the same metadata.
6511
6516
  export type ChatTemplateKwargs = {
6512
- /** Whether to enable reasoning, enabled by default. */
6517
+ /** Whether to enable reasoning. Support and defaults depend on the model. */
6513
6518
  enable_thinking?: boolean;
6514
6519
  /** If false, preserves reasoning context between turns. */
6515
6520
  clear_thinking?: boolean;
@@ -6530,6 +6535,7 @@ export type ChatCompletionsCommonOptions = {
6530
6535
  parallel_tool_calls?: boolean;
6531
6536
  prediction?: PredictionContent;
6532
6537
  presence_penalty?: number | null;
6538
+ /** Reasoning effort. Supported levels depend on the model. */
6533
6539
  reasoning_effort?: "low" | "medium" | "high" | null;
6534
6540
  chat_template_kwargs?: ChatTemplateKwargs;
6535
6541
  response_format?: ResponseFormat;
@@ -10739,11 +10745,69 @@ export declare abstract class Base_Ai_Cf_Pipecat_Ai_Smart_Turn_V2 {
10739
10745
  postProcessedOutputs: Ai_Cf_Pipecat_Ai_Smart_Turn_V2_Output;
10740
10746
  }
10741
10747
  export declare abstract class Base_Ai_Cf_Openai_Gpt_Oss_120B {
10742
- inputs: XOR<ResponsesInput, ChatCompletionsMessagesInput>;
10748
+ inputs: XOR<
10749
+ Omit<ResponsesInput, "reasoning"> & {
10750
+ reasoning?:
10751
+ | (Omit<Reasoning, "effort"> & {
10752
+ /**
10753
+ * Reasoning effort. Supported levels: low, medium, high. Reasoning cannot be disabled.
10754
+ *
10755
+ * @default "medium"
10756
+ */
10757
+ effort?: "low" | "medium" | "high" | null;
10758
+ })
10759
+ | null;
10760
+ },
10761
+ Omit<ChatCompletionsInput, "reasoning_effort" | "chat_template_kwargs"> & {
10762
+ /**
10763
+ * Reasoning effort. Supported levels: low, medium, high. Reasoning cannot be disabled.
10764
+ *
10765
+ * @default "medium"
10766
+ */
10767
+ reasoning_effort?: "low" | "medium" | "high" | null;
10768
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
10769
+ /**
10770
+ * Reasoning is always enabled for this model and cannot be disabled.
10771
+ *
10772
+ * @default true
10773
+ */
10774
+ enable_thinking?: true;
10775
+ };
10776
+ }
10777
+ >;
10743
10778
  postProcessedOutputs: XOR<ResponsesOutput, ChatCompletionsOutput>;
10744
10779
  }
10745
10780
  export declare abstract class Base_Ai_Cf_Openai_Gpt_Oss_20B {
10746
- inputs: XOR<ResponsesInput, ChatCompletionsMessagesInput>;
10781
+ inputs: XOR<
10782
+ Omit<ResponsesInput, "reasoning"> & {
10783
+ reasoning?:
10784
+ | (Omit<Reasoning, "effort"> & {
10785
+ /**
10786
+ * Reasoning effort. Supported levels: low, medium, high. Reasoning cannot be disabled.
10787
+ *
10788
+ * @default "medium"
10789
+ */
10790
+ effort?: "low" | "medium" | "high" | null;
10791
+ })
10792
+ | null;
10793
+ },
10794
+ Omit<ChatCompletionsInput, "reasoning_effort" | "chat_template_kwargs"> & {
10795
+ /**
10796
+ * Reasoning effort. Supported levels: low, medium, high. Reasoning cannot be disabled.
10797
+ *
10798
+ * @default "medium"
10799
+ */
10800
+ reasoning_effort?: "low" | "medium" | "high" | null;
10801
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
10802
+ /**
10803
+ * Reasoning is always enabled for this model and cannot be disabled.
10804
+ *
10805
+ * @default true
10806
+ */
10807
+ enable_thinking?: true;
10808
+ };
10809
+ }
10810
+ >;
10747
10811
  postProcessedOutputs: XOR<ResponsesOutput, ChatCompletionsOutput>;
10748
10812
  }
10749
10813
  export interface Ai_Cf_Leonardo_Phoenix_1_0_Input {
@@ -11826,7 +11890,19 @@ export declare abstract class Base_Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B {
11826
11890
  postProcessedOutputs: Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B_Output;
11827
11891
  }
11828
11892
  export declare abstract class Base_Ai_Cf_Zai_Org_Glm_4_7_Flash {
11829
- inputs: ChatCompletionsInput;
11893
+ inputs: Omit<
11894
+ ChatCompletionsInput,
11895
+ "reasoning_effort" | "chat_template_kwargs"
11896
+ > & {
11897
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11898
+ /**
11899
+ * Whether to enable reasoning for this model. This model has no reasoning effort levels.
11900
+ *
11901
+ * @default true
11902
+ */
11903
+ enable_thinking?: boolean;
11904
+ };
11905
+ };
11830
11906
  postProcessedOutputs: ChatCompletionsOutput;
11831
11907
  }
11832
11908
  export declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_5 {
@@ -11834,23 +11910,168 @@ export declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_5 {
11834
11910
  postProcessedOutputs: ChatCompletionsOutput;
11835
11911
  }
11836
11912
  export declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_6 {
11837
- inputs: ChatCompletionsInput;
11913
+ inputs: Omit<
11914
+ ChatCompletionsInput,
11915
+ "reasoning_effort" | "chat_template_kwargs"
11916
+ > & {
11917
+ /**
11918
+ * Reasoning effort. Supported levels: high, none. Compatibility aliases (accepted by the API, not by these types): low maps to high; medium maps to high; max maps to high.
11919
+ *
11920
+ * @default "high"
11921
+ */
11922
+ reasoning_effort?: "high" | "none" | null;
11923
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11924
+ /**
11925
+ * Whether to enable reasoning for this model.
11926
+ *
11927
+ * @default true
11928
+ */
11929
+ enable_thinking?: boolean;
11930
+ };
11931
+ };
11838
11932
  postProcessedOutputs: ChatCompletionsOutput;
11839
11933
  }
11934
+ export type Ai_Cf_Nvidia_Nemotron_3_120B_A12B_Input = Omit<
11935
+ ChatCompletionsInput,
11936
+ | "model"
11937
+ | "max_tokens"
11938
+ | "metadata"
11939
+ | "modalities"
11940
+ | "chat_template_kwargs"
11941
+ | "store"
11942
+ | "reasoning_effort"
11943
+ > & {
11944
+ /**
11945
+ * ID of the model to use (for example, '@cf/nvidia/nemotron-3-120b-a12b').
11946
+ */
11947
+ model?: ChatCompletionsInput["model"];
11948
+ /**
11949
+ * The maximum number of tokens to generate.
11950
+ */
11951
+ max_tokens?: ChatCompletionsInput["max_tokens"];
11952
+ /**
11953
+ * Set of key-value pairs that can be attached to the object.
11954
+ */
11955
+ metadata?: ChatCompletionsInput["metadata"];
11956
+ /**
11957
+ * Output types requested from the model.
11958
+ */
11959
+ modalities?: ChatCompletionsInput["modalities"];
11960
+ /**
11961
+ * Nemotron chat-template controls for normal reasoning, low-effort reasoning, and non-reasoning responses.
11962
+ */
11963
+ chat_template_kwargs?: {
11964
+ /**
11965
+ * Whether to enable reasoning. Reasoning is enabled by default.
11966
+ */
11967
+ enable_thinking?: boolean;
11968
+ /**
11969
+ * When reasoning is enabled, use Nemotron's low-effort reasoning mode, which uses significantly fewer reasoning tokens.
11970
+ */
11971
+ low_effort?: boolean;
11972
+ /**
11973
+ * For coding agent use, Nvidia suggests setting force_nonempty_content=true
11974
+ */
11975
+ force_nonempty_content?: boolean;
11976
+ };
11977
+ /**
11978
+ * Whether to store the output for model distillation or evaluation.
11979
+ *
11980
+ * @default false
11981
+ */
11982
+ store?: ChatCompletionsInput["store"];
11983
+ };
11840
11984
  export declare abstract class Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B {
11841
- inputs: ChatCompletionsInput;
11985
+ inputs: Ai_Cf_Nvidia_Nemotron_3_120B_A12B_Input;
11842
11986
  postProcessedOutputs: ChatCompletionsOutput;
11843
11987
  }
11844
- export declare abstract class Base_Ai_Cf_Google_Gemma_4_26B_A4B_IT {
11845
- inputs: ChatCompletionsInput;
11988
+ export type Ai_Cf_Google_Gemma_4_26B_A4B_It_Input = Omit<
11989
+ ChatCompletionsInput,
11990
+ "reasoning_effort" | "chat_template_kwargs"
11991
+ > & {
11992
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11993
+ /**
11994
+ * Whether to enable reasoning for this model. This model has no reasoning effort levels.
11995
+ *
11996
+ * @default true
11997
+ */
11998
+ enable_thinking?: boolean;
11999
+ };
12000
+ } & {
12001
+ /**
12002
+ * @default false
12003
+ */
12004
+ skip_special_tokens?: boolean;
12005
+ };
12006
+ export declare abstract class Base_Ai_Cf_Google_Gemma_4_26B_A4B_It {
12007
+ inputs: Ai_Cf_Google_Gemma_4_26B_A4B_It_Input;
11846
12008
  postProcessedOutputs: ChatCompletionsOutput;
11847
12009
  }
12010
+ /** @deprecated Use Base_Ai_Cf_Google_Gemma_4_26B_A4B_It. */
12011
+ export declare abstract class Base_Ai_Cf_Google_Gemma_4_26B_A4B_IT extends Base_Ai_Cf_Google_Gemma_4_26B_A4B_It {}
12012
+ export type Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B_Input =
12013
+ | {
12014
+ /**
12015
+ * readable stream with audio data and content-type specified for that data
12016
+ */
12017
+ audio: {
12018
+ body: object;
12019
+ contentType: string;
12020
+ };
12021
+ }
12022
+ | {
12023
+ /**
12024
+ * base64 encoded audio data
12025
+ */
12026
+ audio: string;
12027
+ encoding?: "wav" | "flac" | "ogg" | "linear16";
12028
+ sample_rate?: number;
12029
+ channels?: number;
12030
+ };
12031
+ export interface Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B_Output {
12032
+ text?: string;
12033
+ duration?: number;
12034
+ }
12035
+ export declare abstract class Base_Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B {
12036
+ inputs: Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B_Input;
12037
+ postProcessedOutputs: Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B_Output;
12038
+ }
11848
12039
  export declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_7_Code {
11849
- inputs: ChatCompletionsInput;
12040
+ inputs: Omit<
12041
+ ChatCompletionsInput,
12042
+ "reasoning_effort" | "chat_template_kwargs"
12043
+ > & {
12044
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
12045
+ /**
12046
+ * Reasoning is always enabled for this model and cannot be disabled. This model has no reasoning effort levels.
12047
+ *
12048
+ * @default true
12049
+ */
12050
+ enable_thinking?: true;
12051
+ };
12052
+ };
11850
12053
  postProcessedOutputs: ChatCompletionsOutput;
11851
12054
  }
11852
12055
  export declare abstract class Base_Ai_Cf_Zai_Org_Glm_5_2 {
11853
- inputs: ChatCompletionsInput;
12056
+ inputs: Omit<
12057
+ ChatCompletionsInput,
12058
+ "reasoning_effort" | "chat_template_kwargs"
12059
+ > & {
12060
+ /**
12061
+ * Reasoning effort. Supported levels: max, high, none. Compatibility aliases (accepted by the API, not by these types): low maps to high; medium maps to high; xhigh maps to max; minimal maps to none.
12062
+ *
12063
+ * @default "max"
12064
+ */
12065
+ reasoning_effort?: "max" | "high" | "none" | null;
12066
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
12067
+ /**
12068
+ * Whether to enable reasoning for this model.
12069
+ *
12070
+ * @default true
12071
+ */
12072
+ enable_thinking?: boolean;
12073
+ };
12074
+ };
11854
12075
  postProcessedOutputs: ChatCompletionsOutput;
11855
12076
  }
11856
12077
  export interface Ai_Cf_Moondream_Moondream3_1_9B_A2B_Input {
@@ -11987,26 +12208,119 @@ export declare abstract class Base_Ai_Cf_Moondream_Moondream3_1_9B_A2B {
11987
12208
  postProcessedOutputs: Ai_Cf_Moondream_Moondream3_1_9B_A2B_Output;
11988
12209
  }
11989
12210
  export declare abstract class Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Flash_0731 {
11990
- inputs: ChatCompletionsInput;
12211
+ inputs: Omit<
12212
+ ChatCompletionsInput,
12213
+ "reasoning_effort" | "chat_template_kwargs"
12214
+ > & {
12215
+ /**
12216
+ * Reasoning effort. Supported levels: max, high, low, none. Compatibility aliases (accepted by the API, not by these types): minimal maps to low; medium maps to high; xhigh maps to high.
12217
+ *
12218
+ * @default "high"
12219
+ */
12220
+ reasoning_effort?: "max" | "high" | "low" | "none" | null;
12221
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
12222
+ /**
12223
+ * Whether to enable reasoning for this model.
12224
+ *
12225
+ * @default true
12226
+ */
12227
+ enable_thinking?: boolean;
12228
+ };
12229
+ };
11991
12230
  postProcessedOutputs: ChatCompletionsOutput;
11992
12231
  }
11993
12232
  export declare abstract class Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Pro_0813 {
11994
- inputs: ChatCompletionsInput;
12233
+ inputs: Omit<
12234
+ ChatCompletionsInput,
12235
+ "reasoning_effort" | "chat_template_kwargs"
12236
+ > & {
12237
+ /**
12238
+ * Reasoning effort. Supported levels: max, high, low, none. Compatibility aliases (accepted by the API, not by these types): minimal maps to low; medium maps to high; xhigh maps to high.
12239
+ *
12240
+ * @default "high"
12241
+ */
12242
+ reasoning_effort?: "max" | "high" | "low" | "none" | null;
12243
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
12244
+ /**
12245
+ * Whether to enable reasoning for this model.
12246
+ *
12247
+ * @default true
12248
+ */
12249
+ enable_thinking?: boolean;
12250
+ };
12251
+ };
11995
12252
  postProcessedOutputs: ChatCompletionsOutput;
11996
12253
  }
11997
12254
  export declare abstract class Base_Ai_Cf_Qwen_Qwen3_8_27B {
11998
- inputs: ChatCompletionsInput;
12255
+ inputs: Omit<
12256
+ ChatCompletionsInput,
12257
+ "reasoning_effort" | "chat_template_kwargs"
12258
+ > & {
12259
+ /**
12260
+ * Reasoning effort. Supported levels: low, medium, xhigh.
12261
+ *
12262
+ * @default "xhigh"
12263
+ */
12264
+ reasoning_effort?: "low" | "medium" | "xhigh" | null;
12265
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
12266
+ /**
12267
+ * Whether to enable reasoning for this model.
12268
+ *
12269
+ * @default true
12270
+ */
12271
+ enable_thinking?: boolean;
12272
+ };
12273
+ };
12274
+ postProcessedOutputs: ChatCompletionsOutput;
12275
+ }
12276
+ export declare abstract class Base_Ai_Cf_Zai_Org_Glm_5_3 {
12277
+ inputs: Omit<
12278
+ ChatCompletionsInput,
12279
+ "reasoning_effort" | "chat_template_kwargs"
12280
+ > & {
12281
+ /**
12282
+ * Reasoning effort. Supported levels: max, high, low. Reasoning cannot be disabled. Compatibility aliases (accepted by the API, not by these types): none maps to max; minimal maps to max; medium maps to max; xhigh maps to max.
12283
+ *
12284
+ * @default "max"
12285
+ */
12286
+ reasoning_effort?: "max" | "high" | "low" | null;
12287
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
12288
+ /**
12289
+ * Reasoning is always enabled for this model and cannot be disabled.
12290
+ *
12291
+ * @default true
12292
+ */
12293
+ enable_thinking?: true;
12294
+ };
12295
+ };
11999
12296
  postProcessedOutputs: ChatCompletionsOutput;
12000
12297
  }
12001
12298
  export declare abstract class Base_Ai_Cf_Zai_Org_Glm_5_3_Flash {
12002
- inputs: ChatCompletionsInput;
12299
+ inputs: Omit<
12300
+ ChatCompletionsInput,
12301
+ "reasoning_effort" | "chat_template_kwargs"
12302
+ > & {
12303
+ /**
12304
+ * Reasoning effort. Supported levels: max, high, low. Reasoning cannot be disabled. Compatibility aliases (accepted by the API, not by these types): none maps to max; minimal maps to max; medium maps to max; xhigh maps to max.
12305
+ *
12306
+ * @default "max"
12307
+ */
12308
+ reasoning_effort?: "max" | "high" | "low" | null;
12309
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
12310
+ /**
12311
+ * Reasoning is always enabled for this model and cannot be disabled.
12312
+ *
12313
+ * @default true
12314
+ */
12315
+ enable_thinking?: true;
12316
+ };
12317
+ };
12003
12318
  postProcessedOutputs: ChatCompletionsOutput;
12004
12319
  }
12005
12320
  export interface AiModels {
12006
12321
  "@cf/huggingface/distilbert-sst-2-int8": BaseAiTextClassification;
12007
12322
  "@cf/stabilityai/stable-diffusion-xl-base-1.0": BaseAiTextToImage;
12008
12323
  "@cf/runwayml/stable-diffusion-v1-5-inpainting": BaseAiTextToImage;
12009
- "@cf/runwayml/stable-diffusion-v1-5-img2img": BaseAiTextToImage;
12010
12324
  "@cf/lykon/dreamshaper-8-lcm": BaseAiTextToImage;
12011
12325
  "@cf/bytedance/stable-diffusion-xl-lightning": BaseAiTextToImage;
12012
12326
  "@cf/myshell-ai/melotts": BaseAiTextToSpeech;
@@ -12093,13 +12407,15 @@ export interface AiModels {
12093
12407
  "@cf/moonshotai/kimi-k2.5": Base_Ai_Cf_Moonshotai_Kimi_K2_5;
12094
12408
  "@cf/moonshotai/kimi-k2.6": Base_Ai_Cf_Moonshotai_Kimi_K2_6;
12095
12409
  "@cf/nvidia/nemotron-3-120b-a12b": Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B;
12096
- "@cf/google/gemma-4-26b-a4b-it": Base_Ai_Cf_Google_Gemma_4_26B_A4B_IT;
12410
+ "@cf/google/gemma-4-26b-a4b-it": Base_Ai_Cf_Google_Gemma_4_26B_A4B_It;
12411
+ "@cf/nvidia/nemotron-speech-streaming-en-0.6b": Base_Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B;
12097
12412
  "@cf/moonshotai/kimi-k2.7-code": Base_Ai_Cf_Moonshotai_Kimi_K2_7_Code;
12098
12413
  "@cf/zai-org/glm-5.2": Base_Ai_Cf_Zai_Org_Glm_5_2;
12099
12414
  "@cf/moondream/moondream3.1-9B-A2B": Base_Ai_Cf_Moondream_Moondream3_1_9B_A2B;
12100
12415
  "@cf/deepseek-ai/deepseek-v4-flash-0731": Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Flash_0731;
12101
12416
  "@cf/deepseek-ai/deepseek-v4-pro-0813": Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Pro_0813;
12102
12417
  "@cf/qwen/qwen3.8-27b": Base_Ai_Cf_Qwen_Qwen3_8_27B;
12418
+ "@cf/zai-org/glm-5.3": Base_Ai_Cf_Zai_Org_Glm_5_3;
12103
12419
  "@cf/zai-org/glm-5.3-flash": Base_Ai_Cf_Zai_Org_Glm_5_3_Flash;
12104
12420
  }
12105
12421
  export type AiOptions = {