@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.
package/index.d.ts CHANGED
@@ -6214,8 +6214,13 @@ type WebSearchOptions = {
6214
6214
  search_context_size?: "low" | "medium" | "high";
6215
6215
  user_location?: WebSearchUserLocation;
6216
6216
  };
6217
+ // Source of truth for per-model reasoning types: each model's `reasoning_effort` metadata
6218
+ // in Workers AI ConfigAPI (supported efforts, aliases, defaults, and whether reasoning can
6219
+ // be turned off). The Workers AI SDK type generator (cloudflare/ai/sdk,
6220
+ // apps/worker-constellation-entry/scripts/build-types) turns it into the per-model
6221
+ // `inputs` types below; the developer docs model schemas come from the same metadata.
6217
6222
  type ChatTemplateKwargs = {
6218
- /** Whether to enable reasoning, enabled by default. */
6223
+ /** Whether to enable reasoning. Support and defaults depend on the model. */
6219
6224
  enable_thinking?: boolean;
6220
6225
  /** If false, preserves reasoning context between turns. */
6221
6226
  clear_thinking?: boolean;
@@ -6236,6 +6241,7 @@ type ChatCompletionsCommonOptions = {
6236
6241
  parallel_tool_calls?: boolean;
6237
6242
  prediction?: PredictionContent;
6238
6243
  presence_penalty?: number | null;
6244
+ /** Reasoning effort. Supported levels depend on the model. */
6239
6245
  reasoning_effort?: "low" | "medium" | "high" | null;
6240
6246
  chat_template_kwargs?: ChatTemplateKwargs;
6241
6247
  response_format?: ResponseFormat;
@@ -10444,11 +10450,69 @@ declare abstract class Base_Ai_Cf_Pipecat_Ai_Smart_Turn_V2 {
10444
10450
  postProcessedOutputs: Ai_Cf_Pipecat_Ai_Smart_Turn_V2_Output;
10445
10451
  }
10446
10452
  declare abstract class Base_Ai_Cf_Openai_Gpt_Oss_120B {
10447
- inputs: XOR<ResponsesInput, ChatCompletionsMessagesInput>;
10453
+ inputs: XOR<
10454
+ Omit<ResponsesInput, "reasoning"> & {
10455
+ reasoning?:
10456
+ | (Omit<Reasoning, "effort"> & {
10457
+ /**
10458
+ * Reasoning effort. Supported levels: low, medium, high. Reasoning cannot be disabled.
10459
+ *
10460
+ * @default "medium"
10461
+ */
10462
+ effort?: "low" | "medium" | "high" | null;
10463
+ })
10464
+ | null;
10465
+ },
10466
+ Omit<ChatCompletionsInput, "reasoning_effort" | "chat_template_kwargs"> & {
10467
+ /**
10468
+ * Reasoning effort. Supported levels: low, medium, high. Reasoning cannot be disabled.
10469
+ *
10470
+ * @default "medium"
10471
+ */
10472
+ reasoning_effort?: "low" | "medium" | "high" | null;
10473
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
10474
+ /**
10475
+ * Reasoning is always enabled for this model and cannot be disabled.
10476
+ *
10477
+ * @default true
10478
+ */
10479
+ enable_thinking?: true;
10480
+ };
10481
+ }
10482
+ >;
10448
10483
  postProcessedOutputs: XOR<ResponsesOutput, ChatCompletionsOutput>;
10449
10484
  }
10450
10485
  declare abstract class Base_Ai_Cf_Openai_Gpt_Oss_20B {
10451
- inputs: XOR<ResponsesInput, ChatCompletionsMessagesInput>;
10486
+ inputs: XOR<
10487
+ Omit<ResponsesInput, "reasoning"> & {
10488
+ reasoning?:
10489
+ | (Omit<Reasoning, "effort"> & {
10490
+ /**
10491
+ * Reasoning effort. Supported levels: low, medium, high. Reasoning cannot be disabled.
10492
+ *
10493
+ * @default "medium"
10494
+ */
10495
+ effort?: "low" | "medium" | "high" | null;
10496
+ })
10497
+ | null;
10498
+ },
10499
+ Omit<ChatCompletionsInput, "reasoning_effort" | "chat_template_kwargs"> & {
10500
+ /**
10501
+ * Reasoning effort. Supported levels: low, medium, high. Reasoning cannot be disabled.
10502
+ *
10503
+ * @default "medium"
10504
+ */
10505
+ reasoning_effort?: "low" | "medium" | "high" | null;
10506
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
10507
+ /**
10508
+ * Reasoning is always enabled for this model and cannot be disabled.
10509
+ *
10510
+ * @default true
10511
+ */
10512
+ enable_thinking?: true;
10513
+ };
10514
+ }
10515
+ >;
10452
10516
  postProcessedOutputs: XOR<ResponsesOutput, ChatCompletionsOutput>;
10453
10517
  }
10454
10518
  interface Ai_Cf_Leonardo_Phoenix_1_0_Input {
@@ -11531,7 +11595,19 @@ declare abstract class Base_Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B {
11531
11595
  postProcessedOutputs: Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B_Output;
11532
11596
  }
11533
11597
  declare abstract class Base_Ai_Cf_Zai_Org_Glm_4_7_Flash {
11534
- inputs: ChatCompletionsInput;
11598
+ inputs: Omit<
11599
+ ChatCompletionsInput,
11600
+ "reasoning_effort" | "chat_template_kwargs"
11601
+ > & {
11602
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11603
+ /**
11604
+ * Whether to enable reasoning for this model. This model has no reasoning effort levels.
11605
+ *
11606
+ * @default true
11607
+ */
11608
+ enable_thinking?: boolean;
11609
+ };
11610
+ };
11535
11611
  postProcessedOutputs: ChatCompletionsOutput;
11536
11612
  }
11537
11613
  declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_5 {
@@ -11539,23 +11615,168 @@ declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_5 {
11539
11615
  postProcessedOutputs: ChatCompletionsOutput;
11540
11616
  }
11541
11617
  declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_6 {
11542
- inputs: ChatCompletionsInput;
11618
+ inputs: Omit<
11619
+ ChatCompletionsInput,
11620
+ "reasoning_effort" | "chat_template_kwargs"
11621
+ > & {
11622
+ /**
11623
+ * 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.
11624
+ *
11625
+ * @default "high"
11626
+ */
11627
+ reasoning_effort?: "high" | "none" | null;
11628
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11629
+ /**
11630
+ * Whether to enable reasoning for this model.
11631
+ *
11632
+ * @default true
11633
+ */
11634
+ enable_thinking?: boolean;
11635
+ };
11636
+ };
11543
11637
  postProcessedOutputs: ChatCompletionsOutput;
11544
11638
  }
11639
+ type Ai_Cf_Nvidia_Nemotron_3_120B_A12B_Input = Omit<
11640
+ ChatCompletionsInput,
11641
+ | "model"
11642
+ | "max_tokens"
11643
+ | "metadata"
11644
+ | "modalities"
11645
+ | "chat_template_kwargs"
11646
+ | "store"
11647
+ | "reasoning_effort"
11648
+ > & {
11649
+ /**
11650
+ * ID of the model to use (for example, '@cf/nvidia/nemotron-3-120b-a12b').
11651
+ */
11652
+ model?: ChatCompletionsInput["model"];
11653
+ /**
11654
+ * The maximum number of tokens to generate.
11655
+ */
11656
+ max_tokens?: ChatCompletionsInput["max_tokens"];
11657
+ /**
11658
+ * Set of key-value pairs that can be attached to the object.
11659
+ */
11660
+ metadata?: ChatCompletionsInput["metadata"];
11661
+ /**
11662
+ * Output types requested from the model.
11663
+ */
11664
+ modalities?: ChatCompletionsInput["modalities"];
11665
+ /**
11666
+ * Nemotron chat-template controls for normal reasoning, low-effort reasoning, and non-reasoning responses.
11667
+ */
11668
+ chat_template_kwargs?: {
11669
+ /**
11670
+ * Whether to enable reasoning. Reasoning is enabled by default.
11671
+ */
11672
+ enable_thinking?: boolean;
11673
+ /**
11674
+ * When reasoning is enabled, use Nemotron's low-effort reasoning mode, which uses significantly fewer reasoning tokens.
11675
+ */
11676
+ low_effort?: boolean;
11677
+ /**
11678
+ * For coding agent use, Nvidia suggests setting force_nonempty_content=true
11679
+ */
11680
+ force_nonempty_content?: boolean;
11681
+ };
11682
+ /**
11683
+ * Whether to store the output for model distillation or evaluation.
11684
+ *
11685
+ * @default false
11686
+ */
11687
+ store?: ChatCompletionsInput["store"];
11688
+ };
11545
11689
  declare abstract class Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B {
11546
- inputs: ChatCompletionsInput;
11690
+ inputs: Ai_Cf_Nvidia_Nemotron_3_120B_A12B_Input;
11547
11691
  postProcessedOutputs: ChatCompletionsOutput;
11548
11692
  }
11549
- declare abstract class Base_Ai_Cf_Google_Gemma_4_26B_A4B_IT {
11550
- inputs: ChatCompletionsInput;
11693
+ type Ai_Cf_Google_Gemma_4_26B_A4B_It_Input = Omit<
11694
+ ChatCompletionsInput,
11695
+ "reasoning_effort" | "chat_template_kwargs"
11696
+ > & {
11697
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11698
+ /**
11699
+ * Whether to enable reasoning for this model. This model has no reasoning effort levels.
11700
+ *
11701
+ * @default true
11702
+ */
11703
+ enable_thinking?: boolean;
11704
+ };
11705
+ } & {
11706
+ /**
11707
+ * @default false
11708
+ */
11709
+ skip_special_tokens?: boolean;
11710
+ };
11711
+ declare abstract class Base_Ai_Cf_Google_Gemma_4_26B_A4B_It {
11712
+ inputs: Ai_Cf_Google_Gemma_4_26B_A4B_It_Input;
11551
11713
  postProcessedOutputs: ChatCompletionsOutput;
11552
11714
  }
11715
+ /** @deprecated Use Base_Ai_Cf_Google_Gemma_4_26B_A4B_It. */
11716
+ declare abstract class Base_Ai_Cf_Google_Gemma_4_26B_A4B_IT extends Base_Ai_Cf_Google_Gemma_4_26B_A4B_It {}
11717
+ type Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B_Input =
11718
+ | {
11719
+ /**
11720
+ * readable stream with audio data and content-type specified for that data
11721
+ */
11722
+ audio: {
11723
+ body: object;
11724
+ contentType: string;
11725
+ };
11726
+ }
11727
+ | {
11728
+ /**
11729
+ * base64 encoded audio data
11730
+ */
11731
+ audio: string;
11732
+ encoding?: "wav" | "flac" | "ogg" | "linear16";
11733
+ sample_rate?: number;
11734
+ channels?: number;
11735
+ };
11736
+ interface Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B_Output {
11737
+ text?: string;
11738
+ duration?: number;
11739
+ }
11740
+ declare abstract class Base_Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B {
11741
+ inputs: Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B_Input;
11742
+ postProcessedOutputs: Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B_Output;
11743
+ }
11553
11744
  declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_7_Code {
11554
- inputs: ChatCompletionsInput;
11745
+ inputs: Omit<
11746
+ ChatCompletionsInput,
11747
+ "reasoning_effort" | "chat_template_kwargs"
11748
+ > & {
11749
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11750
+ /**
11751
+ * Reasoning is always enabled for this model and cannot be disabled. This model has no reasoning effort levels.
11752
+ *
11753
+ * @default true
11754
+ */
11755
+ enable_thinking?: true;
11756
+ };
11757
+ };
11555
11758
  postProcessedOutputs: ChatCompletionsOutput;
11556
11759
  }
11557
11760
  declare abstract class Base_Ai_Cf_Zai_Org_Glm_5_2 {
11558
- inputs: ChatCompletionsInput;
11761
+ inputs: Omit<
11762
+ ChatCompletionsInput,
11763
+ "reasoning_effort" | "chat_template_kwargs"
11764
+ > & {
11765
+ /**
11766
+ * 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.
11767
+ *
11768
+ * @default "max"
11769
+ */
11770
+ reasoning_effort?: "max" | "high" | "none" | null;
11771
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11772
+ /**
11773
+ * Whether to enable reasoning for this model.
11774
+ *
11775
+ * @default true
11776
+ */
11777
+ enable_thinking?: boolean;
11778
+ };
11779
+ };
11559
11780
  postProcessedOutputs: ChatCompletionsOutput;
11560
11781
  }
11561
11782
  interface Ai_Cf_Moondream_Moondream3_1_9B_A2B_Input {
@@ -11692,26 +11913,119 @@ declare abstract class Base_Ai_Cf_Moondream_Moondream3_1_9B_A2B {
11692
11913
  postProcessedOutputs: Ai_Cf_Moondream_Moondream3_1_9B_A2B_Output;
11693
11914
  }
11694
11915
  declare abstract class Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Flash_0731 {
11695
- inputs: ChatCompletionsInput;
11916
+ inputs: Omit<
11917
+ ChatCompletionsInput,
11918
+ "reasoning_effort" | "chat_template_kwargs"
11919
+ > & {
11920
+ /**
11921
+ * 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.
11922
+ *
11923
+ * @default "high"
11924
+ */
11925
+ reasoning_effort?: "max" | "high" | "low" | "none" | null;
11926
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11927
+ /**
11928
+ * Whether to enable reasoning for this model.
11929
+ *
11930
+ * @default true
11931
+ */
11932
+ enable_thinking?: boolean;
11933
+ };
11934
+ };
11696
11935
  postProcessedOutputs: ChatCompletionsOutput;
11697
11936
  }
11698
11937
  declare abstract class Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Pro_0813 {
11699
- inputs: ChatCompletionsInput;
11938
+ inputs: Omit<
11939
+ ChatCompletionsInput,
11940
+ "reasoning_effort" | "chat_template_kwargs"
11941
+ > & {
11942
+ /**
11943
+ * 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.
11944
+ *
11945
+ * @default "high"
11946
+ */
11947
+ reasoning_effort?: "max" | "high" | "low" | "none" | null;
11948
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11949
+ /**
11950
+ * Whether to enable reasoning for this model.
11951
+ *
11952
+ * @default true
11953
+ */
11954
+ enable_thinking?: boolean;
11955
+ };
11956
+ };
11700
11957
  postProcessedOutputs: ChatCompletionsOutput;
11701
11958
  }
11702
11959
  declare abstract class Base_Ai_Cf_Qwen_Qwen3_8_27B {
11703
- inputs: ChatCompletionsInput;
11960
+ inputs: Omit<
11961
+ ChatCompletionsInput,
11962
+ "reasoning_effort" | "chat_template_kwargs"
11963
+ > & {
11964
+ /**
11965
+ * Reasoning effort. Supported levels: low, medium, xhigh.
11966
+ *
11967
+ * @default "xhigh"
11968
+ */
11969
+ reasoning_effort?: "low" | "medium" | "xhigh" | null;
11970
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11971
+ /**
11972
+ * Whether to enable reasoning for this model.
11973
+ *
11974
+ * @default true
11975
+ */
11976
+ enable_thinking?: boolean;
11977
+ };
11978
+ };
11979
+ postProcessedOutputs: ChatCompletionsOutput;
11980
+ }
11981
+ declare abstract class Base_Ai_Cf_Zai_Org_Glm_5_3 {
11982
+ inputs: Omit<
11983
+ ChatCompletionsInput,
11984
+ "reasoning_effort" | "chat_template_kwargs"
11985
+ > & {
11986
+ /**
11987
+ * 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.
11988
+ *
11989
+ * @default "max"
11990
+ */
11991
+ reasoning_effort?: "max" | "high" | "low" | null;
11992
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11993
+ /**
11994
+ * Reasoning is always enabled for this model and cannot be disabled.
11995
+ *
11996
+ * @default true
11997
+ */
11998
+ enable_thinking?: true;
11999
+ };
12000
+ };
11704
12001
  postProcessedOutputs: ChatCompletionsOutput;
11705
12002
  }
11706
12003
  declare abstract class Base_Ai_Cf_Zai_Org_Glm_5_3_Flash {
11707
- inputs: ChatCompletionsInput;
12004
+ inputs: Omit<
12005
+ ChatCompletionsInput,
12006
+ "reasoning_effort" | "chat_template_kwargs"
12007
+ > & {
12008
+ /**
12009
+ * 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.
12010
+ *
12011
+ * @default "max"
12012
+ */
12013
+ reasoning_effort?: "max" | "high" | "low" | null;
12014
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
12015
+ /**
12016
+ * Reasoning is always enabled for this model and cannot be disabled.
12017
+ *
12018
+ * @default true
12019
+ */
12020
+ enable_thinking?: true;
12021
+ };
12022
+ };
11708
12023
  postProcessedOutputs: ChatCompletionsOutput;
11709
12024
  }
11710
12025
  interface AiModels {
11711
12026
  "@cf/huggingface/distilbert-sst-2-int8": BaseAiTextClassification;
11712
12027
  "@cf/stabilityai/stable-diffusion-xl-base-1.0": BaseAiTextToImage;
11713
12028
  "@cf/runwayml/stable-diffusion-v1-5-inpainting": BaseAiTextToImage;
11714
- "@cf/runwayml/stable-diffusion-v1-5-img2img": BaseAiTextToImage;
11715
12029
  "@cf/lykon/dreamshaper-8-lcm": BaseAiTextToImage;
11716
12030
  "@cf/bytedance/stable-diffusion-xl-lightning": BaseAiTextToImage;
11717
12031
  "@cf/myshell-ai/melotts": BaseAiTextToSpeech;
@@ -11798,13 +12112,15 @@ interface AiModels {
11798
12112
  "@cf/moonshotai/kimi-k2.5": Base_Ai_Cf_Moonshotai_Kimi_K2_5;
11799
12113
  "@cf/moonshotai/kimi-k2.6": Base_Ai_Cf_Moonshotai_Kimi_K2_6;
11800
12114
  "@cf/nvidia/nemotron-3-120b-a12b": Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B;
11801
- "@cf/google/gemma-4-26b-a4b-it": Base_Ai_Cf_Google_Gemma_4_26B_A4B_IT;
12115
+ "@cf/google/gemma-4-26b-a4b-it": Base_Ai_Cf_Google_Gemma_4_26B_A4B_It;
12116
+ "@cf/nvidia/nemotron-speech-streaming-en-0.6b": Base_Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B;
11802
12117
  "@cf/moonshotai/kimi-k2.7-code": Base_Ai_Cf_Moonshotai_Kimi_K2_7_Code;
11803
12118
  "@cf/zai-org/glm-5.2": Base_Ai_Cf_Zai_Org_Glm_5_2;
11804
12119
  "@cf/moondream/moondream3.1-9B-A2B": Base_Ai_Cf_Moondream_Moondream3_1_9B_A2B;
11805
12120
  "@cf/deepseek-ai/deepseek-v4-flash-0731": Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Flash_0731;
11806
12121
  "@cf/deepseek-ai/deepseek-v4-pro-0813": Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Pro_0813;
11807
12122
  "@cf/qwen/qwen3.8-27b": Base_Ai_Cf_Qwen_Qwen3_8_27B;
12123
+ "@cf/zai-org/glm-5.3": Base_Ai_Cf_Zai_Org_Glm_5_3;
11808
12124
  "@cf/zai-org/glm-5.3-flash": Base_Ai_Cf_Zai_Org_Glm_5_3_Flash;
11809
12125
  }
11810
12126
  type AiOptions = {