@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.ts CHANGED
@@ -6225,8 +6225,13 @@ export type WebSearchOptions = {
6225
6225
  search_context_size?: "low" | "medium" | "high";
6226
6226
  user_location?: WebSearchUserLocation;
6227
6227
  };
6228
+ // Source of truth for per-model reasoning types: each model's `reasoning_effort` metadata
6229
+ // in Workers AI ConfigAPI (supported efforts, aliases, defaults, and whether reasoning can
6230
+ // be turned off). The Workers AI SDK type generator (cloudflare/ai/sdk,
6231
+ // apps/worker-constellation-entry/scripts/build-types) turns it into the per-model
6232
+ // `inputs` types below; the developer docs model schemas come from the same metadata.
6228
6233
  export type ChatTemplateKwargs = {
6229
- /** Whether to enable reasoning, enabled by default. */
6234
+ /** Whether to enable reasoning. Support and defaults depend on the model. */
6230
6235
  enable_thinking?: boolean;
6231
6236
  /** If false, preserves reasoning context between turns. */
6232
6237
  clear_thinking?: boolean;
@@ -6247,6 +6252,7 @@ export type ChatCompletionsCommonOptions = {
6247
6252
  parallel_tool_calls?: boolean;
6248
6253
  prediction?: PredictionContent;
6249
6254
  presence_penalty?: number | null;
6255
+ /** Reasoning effort. Supported levels depend on the model. */
6250
6256
  reasoning_effort?: "low" | "medium" | "high" | null;
6251
6257
  chat_template_kwargs?: ChatTemplateKwargs;
6252
6258
  response_format?: ResponseFormat;
@@ -10456,11 +10462,69 @@ export declare abstract class Base_Ai_Cf_Pipecat_Ai_Smart_Turn_V2 {
10456
10462
  postProcessedOutputs: Ai_Cf_Pipecat_Ai_Smart_Turn_V2_Output;
10457
10463
  }
10458
10464
  export declare abstract class Base_Ai_Cf_Openai_Gpt_Oss_120B {
10459
- inputs: XOR<ResponsesInput, ChatCompletionsMessagesInput>;
10465
+ inputs: XOR<
10466
+ Omit<ResponsesInput, "reasoning"> & {
10467
+ reasoning?:
10468
+ | (Omit<Reasoning, "effort"> & {
10469
+ /**
10470
+ * Reasoning effort. Supported levels: low, medium, high. Reasoning cannot be disabled.
10471
+ *
10472
+ * @default "medium"
10473
+ */
10474
+ effort?: "low" | "medium" | "high" | null;
10475
+ })
10476
+ | null;
10477
+ },
10478
+ Omit<ChatCompletionsInput, "reasoning_effort" | "chat_template_kwargs"> & {
10479
+ /**
10480
+ * Reasoning effort. Supported levels: low, medium, high. Reasoning cannot be disabled.
10481
+ *
10482
+ * @default "medium"
10483
+ */
10484
+ reasoning_effort?: "low" | "medium" | "high" | null;
10485
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
10486
+ /**
10487
+ * Reasoning is always enabled for this model and cannot be disabled.
10488
+ *
10489
+ * @default true
10490
+ */
10491
+ enable_thinking?: true;
10492
+ };
10493
+ }
10494
+ >;
10460
10495
  postProcessedOutputs: XOR<ResponsesOutput, ChatCompletionsOutput>;
10461
10496
  }
10462
10497
  export declare abstract class Base_Ai_Cf_Openai_Gpt_Oss_20B {
10463
- inputs: XOR<ResponsesInput, ChatCompletionsMessagesInput>;
10498
+ inputs: XOR<
10499
+ Omit<ResponsesInput, "reasoning"> & {
10500
+ reasoning?:
10501
+ | (Omit<Reasoning, "effort"> & {
10502
+ /**
10503
+ * Reasoning effort. Supported levels: low, medium, high. Reasoning cannot be disabled.
10504
+ *
10505
+ * @default "medium"
10506
+ */
10507
+ effort?: "low" | "medium" | "high" | null;
10508
+ })
10509
+ | null;
10510
+ },
10511
+ Omit<ChatCompletionsInput, "reasoning_effort" | "chat_template_kwargs"> & {
10512
+ /**
10513
+ * Reasoning effort. Supported levels: low, medium, high. Reasoning cannot be disabled.
10514
+ *
10515
+ * @default "medium"
10516
+ */
10517
+ reasoning_effort?: "low" | "medium" | "high" | null;
10518
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
10519
+ /**
10520
+ * Reasoning is always enabled for this model and cannot be disabled.
10521
+ *
10522
+ * @default true
10523
+ */
10524
+ enable_thinking?: true;
10525
+ };
10526
+ }
10527
+ >;
10464
10528
  postProcessedOutputs: XOR<ResponsesOutput, ChatCompletionsOutput>;
10465
10529
  }
10466
10530
  export interface Ai_Cf_Leonardo_Phoenix_1_0_Input {
@@ -11543,7 +11607,19 @@ export declare abstract class Base_Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B {
11543
11607
  postProcessedOutputs: Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B_Output;
11544
11608
  }
11545
11609
  export declare abstract class Base_Ai_Cf_Zai_Org_Glm_4_7_Flash {
11546
- inputs: ChatCompletionsInput;
11610
+ inputs: Omit<
11611
+ ChatCompletionsInput,
11612
+ "reasoning_effort" | "chat_template_kwargs"
11613
+ > & {
11614
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11615
+ /**
11616
+ * Whether to enable reasoning for this model. This model has no reasoning effort levels.
11617
+ *
11618
+ * @default true
11619
+ */
11620
+ enable_thinking?: boolean;
11621
+ };
11622
+ };
11547
11623
  postProcessedOutputs: ChatCompletionsOutput;
11548
11624
  }
11549
11625
  export declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_5 {
@@ -11551,23 +11627,168 @@ export declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_5 {
11551
11627
  postProcessedOutputs: ChatCompletionsOutput;
11552
11628
  }
11553
11629
  export declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_6 {
11554
- inputs: ChatCompletionsInput;
11630
+ inputs: Omit<
11631
+ ChatCompletionsInput,
11632
+ "reasoning_effort" | "chat_template_kwargs"
11633
+ > & {
11634
+ /**
11635
+ * 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.
11636
+ *
11637
+ * @default "high"
11638
+ */
11639
+ reasoning_effort?: "high" | "none" | null;
11640
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11641
+ /**
11642
+ * Whether to enable reasoning for this model.
11643
+ *
11644
+ * @default true
11645
+ */
11646
+ enable_thinking?: boolean;
11647
+ };
11648
+ };
11555
11649
  postProcessedOutputs: ChatCompletionsOutput;
11556
11650
  }
11651
+ export type Ai_Cf_Nvidia_Nemotron_3_120B_A12B_Input = Omit<
11652
+ ChatCompletionsInput,
11653
+ | "model"
11654
+ | "max_tokens"
11655
+ | "metadata"
11656
+ | "modalities"
11657
+ | "chat_template_kwargs"
11658
+ | "store"
11659
+ | "reasoning_effort"
11660
+ > & {
11661
+ /**
11662
+ * ID of the model to use (for example, '@cf/nvidia/nemotron-3-120b-a12b').
11663
+ */
11664
+ model?: ChatCompletionsInput["model"];
11665
+ /**
11666
+ * The maximum number of tokens to generate.
11667
+ */
11668
+ max_tokens?: ChatCompletionsInput["max_tokens"];
11669
+ /**
11670
+ * Set of key-value pairs that can be attached to the object.
11671
+ */
11672
+ metadata?: ChatCompletionsInput["metadata"];
11673
+ /**
11674
+ * Output types requested from the model.
11675
+ */
11676
+ modalities?: ChatCompletionsInput["modalities"];
11677
+ /**
11678
+ * Nemotron chat-template controls for normal reasoning, low-effort reasoning, and non-reasoning responses.
11679
+ */
11680
+ chat_template_kwargs?: {
11681
+ /**
11682
+ * Whether to enable reasoning. Reasoning is enabled by default.
11683
+ */
11684
+ enable_thinking?: boolean;
11685
+ /**
11686
+ * When reasoning is enabled, use Nemotron's low-effort reasoning mode, which uses significantly fewer reasoning tokens.
11687
+ */
11688
+ low_effort?: boolean;
11689
+ /**
11690
+ * For coding agent use, Nvidia suggests setting force_nonempty_content=true
11691
+ */
11692
+ force_nonempty_content?: boolean;
11693
+ };
11694
+ /**
11695
+ * Whether to store the output for model distillation or evaluation.
11696
+ *
11697
+ * @default false
11698
+ */
11699
+ store?: ChatCompletionsInput["store"];
11700
+ };
11557
11701
  export declare abstract class Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B {
11558
- inputs: ChatCompletionsInput;
11702
+ inputs: Ai_Cf_Nvidia_Nemotron_3_120B_A12B_Input;
11559
11703
  postProcessedOutputs: ChatCompletionsOutput;
11560
11704
  }
11561
- export declare abstract class Base_Ai_Cf_Google_Gemma_4_26B_A4B_IT {
11562
- inputs: ChatCompletionsInput;
11705
+ export type Ai_Cf_Google_Gemma_4_26B_A4B_It_Input = Omit<
11706
+ ChatCompletionsInput,
11707
+ "reasoning_effort" | "chat_template_kwargs"
11708
+ > & {
11709
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11710
+ /**
11711
+ * Whether to enable reasoning for this model. This model has no reasoning effort levels.
11712
+ *
11713
+ * @default true
11714
+ */
11715
+ enable_thinking?: boolean;
11716
+ };
11717
+ } & {
11718
+ /**
11719
+ * @default false
11720
+ */
11721
+ skip_special_tokens?: boolean;
11722
+ };
11723
+ export declare abstract class Base_Ai_Cf_Google_Gemma_4_26B_A4B_It {
11724
+ inputs: Ai_Cf_Google_Gemma_4_26B_A4B_It_Input;
11563
11725
  postProcessedOutputs: ChatCompletionsOutput;
11564
11726
  }
11727
+ /** @deprecated Use Base_Ai_Cf_Google_Gemma_4_26B_A4B_It. */
11728
+ export declare abstract class Base_Ai_Cf_Google_Gemma_4_26B_A4B_IT extends Base_Ai_Cf_Google_Gemma_4_26B_A4B_It {}
11729
+ export type Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B_Input =
11730
+ | {
11731
+ /**
11732
+ * readable stream with audio data and content-type specified for that data
11733
+ */
11734
+ audio: {
11735
+ body: object;
11736
+ contentType: string;
11737
+ };
11738
+ }
11739
+ | {
11740
+ /**
11741
+ * base64 encoded audio data
11742
+ */
11743
+ audio: string;
11744
+ encoding?: "wav" | "flac" | "ogg" | "linear16";
11745
+ sample_rate?: number;
11746
+ channels?: number;
11747
+ };
11748
+ export interface Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B_Output {
11749
+ text?: string;
11750
+ duration?: number;
11751
+ }
11752
+ export declare abstract class Base_Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B {
11753
+ inputs: Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B_Input;
11754
+ postProcessedOutputs: Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B_Output;
11755
+ }
11565
11756
  export declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_7_Code {
11566
- inputs: ChatCompletionsInput;
11757
+ inputs: Omit<
11758
+ ChatCompletionsInput,
11759
+ "reasoning_effort" | "chat_template_kwargs"
11760
+ > & {
11761
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11762
+ /**
11763
+ * Reasoning is always enabled for this model and cannot be disabled. This model has no reasoning effort levels.
11764
+ *
11765
+ * @default true
11766
+ */
11767
+ enable_thinking?: true;
11768
+ };
11769
+ };
11567
11770
  postProcessedOutputs: ChatCompletionsOutput;
11568
11771
  }
11569
11772
  export declare abstract class Base_Ai_Cf_Zai_Org_Glm_5_2 {
11570
- inputs: ChatCompletionsInput;
11773
+ inputs: Omit<
11774
+ ChatCompletionsInput,
11775
+ "reasoning_effort" | "chat_template_kwargs"
11776
+ > & {
11777
+ /**
11778
+ * 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.
11779
+ *
11780
+ * @default "max"
11781
+ */
11782
+ reasoning_effort?: "max" | "high" | "none" | null;
11783
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11784
+ /**
11785
+ * Whether to enable reasoning for this model.
11786
+ *
11787
+ * @default true
11788
+ */
11789
+ enable_thinking?: boolean;
11790
+ };
11791
+ };
11571
11792
  postProcessedOutputs: ChatCompletionsOutput;
11572
11793
  }
11573
11794
  export interface Ai_Cf_Moondream_Moondream3_1_9B_A2B_Input {
@@ -11704,26 +11925,119 @@ export declare abstract class Base_Ai_Cf_Moondream_Moondream3_1_9B_A2B {
11704
11925
  postProcessedOutputs: Ai_Cf_Moondream_Moondream3_1_9B_A2B_Output;
11705
11926
  }
11706
11927
  export declare abstract class Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Flash_0731 {
11707
- inputs: ChatCompletionsInput;
11928
+ inputs: Omit<
11929
+ ChatCompletionsInput,
11930
+ "reasoning_effort" | "chat_template_kwargs"
11931
+ > & {
11932
+ /**
11933
+ * 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.
11934
+ *
11935
+ * @default "high"
11936
+ */
11937
+ reasoning_effort?: "max" | "high" | "low" | "none" | null;
11938
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11939
+ /**
11940
+ * Whether to enable reasoning for this model.
11941
+ *
11942
+ * @default true
11943
+ */
11944
+ enable_thinking?: boolean;
11945
+ };
11946
+ };
11708
11947
  postProcessedOutputs: ChatCompletionsOutput;
11709
11948
  }
11710
11949
  export declare abstract class Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Pro_0813 {
11711
- inputs: ChatCompletionsInput;
11950
+ inputs: Omit<
11951
+ ChatCompletionsInput,
11952
+ "reasoning_effort" | "chat_template_kwargs"
11953
+ > & {
11954
+ /**
11955
+ * 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.
11956
+ *
11957
+ * @default "high"
11958
+ */
11959
+ reasoning_effort?: "max" | "high" | "low" | "none" | null;
11960
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11961
+ /**
11962
+ * Whether to enable reasoning for this model.
11963
+ *
11964
+ * @default true
11965
+ */
11966
+ enable_thinking?: boolean;
11967
+ };
11968
+ };
11712
11969
  postProcessedOutputs: ChatCompletionsOutput;
11713
11970
  }
11714
11971
  export declare abstract class Base_Ai_Cf_Qwen_Qwen3_8_27B {
11715
- inputs: ChatCompletionsInput;
11972
+ inputs: Omit<
11973
+ ChatCompletionsInput,
11974
+ "reasoning_effort" | "chat_template_kwargs"
11975
+ > & {
11976
+ /**
11977
+ * Reasoning effort. Supported levels: low, medium, xhigh.
11978
+ *
11979
+ * @default "xhigh"
11980
+ */
11981
+ reasoning_effort?: "low" | "medium" | "xhigh" | null;
11982
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
11983
+ /**
11984
+ * Whether to enable reasoning for this model.
11985
+ *
11986
+ * @default true
11987
+ */
11988
+ enable_thinking?: boolean;
11989
+ };
11990
+ };
11991
+ postProcessedOutputs: ChatCompletionsOutput;
11992
+ }
11993
+ export declare abstract class Base_Ai_Cf_Zai_Org_Glm_5_3 {
11994
+ inputs: Omit<
11995
+ ChatCompletionsInput,
11996
+ "reasoning_effort" | "chat_template_kwargs"
11997
+ > & {
11998
+ /**
11999
+ * 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.
12000
+ *
12001
+ * @default "max"
12002
+ */
12003
+ reasoning_effort?: "max" | "high" | "low" | null;
12004
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
12005
+ /**
12006
+ * Reasoning is always enabled for this model and cannot be disabled.
12007
+ *
12008
+ * @default true
12009
+ */
12010
+ enable_thinking?: true;
12011
+ };
12012
+ };
11716
12013
  postProcessedOutputs: ChatCompletionsOutput;
11717
12014
  }
11718
12015
  export declare abstract class Base_Ai_Cf_Zai_Org_Glm_5_3_Flash {
11719
- inputs: ChatCompletionsInput;
12016
+ inputs: Omit<
12017
+ ChatCompletionsInput,
12018
+ "reasoning_effort" | "chat_template_kwargs"
12019
+ > & {
12020
+ /**
12021
+ * 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.
12022
+ *
12023
+ * @default "max"
12024
+ */
12025
+ reasoning_effort?: "max" | "high" | "low" | null;
12026
+ chat_template_kwargs?: Omit<ChatTemplateKwargs, "enable_thinking"> & {
12027
+ /**
12028
+ * Reasoning is always enabled for this model and cannot be disabled.
12029
+ *
12030
+ * @default true
12031
+ */
12032
+ enable_thinking?: true;
12033
+ };
12034
+ };
11720
12035
  postProcessedOutputs: ChatCompletionsOutput;
11721
12036
  }
11722
12037
  export interface AiModels {
11723
12038
  "@cf/huggingface/distilbert-sst-2-int8": BaseAiTextClassification;
11724
12039
  "@cf/stabilityai/stable-diffusion-xl-base-1.0": BaseAiTextToImage;
11725
12040
  "@cf/runwayml/stable-diffusion-v1-5-inpainting": BaseAiTextToImage;
11726
- "@cf/runwayml/stable-diffusion-v1-5-img2img": BaseAiTextToImage;
11727
12041
  "@cf/lykon/dreamshaper-8-lcm": BaseAiTextToImage;
11728
12042
  "@cf/bytedance/stable-diffusion-xl-lightning": BaseAiTextToImage;
11729
12043
  "@cf/myshell-ai/melotts": BaseAiTextToSpeech;
@@ -11810,13 +12124,15 @@ export interface AiModels {
11810
12124
  "@cf/moonshotai/kimi-k2.5": Base_Ai_Cf_Moonshotai_Kimi_K2_5;
11811
12125
  "@cf/moonshotai/kimi-k2.6": Base_Ai_Cf_Moonshotai_Kimi_K2_6;
11812
12126
  "@cf/nvidia/nemotron-3-120b-a12b": Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B;
11813
- "@cf/google/gemma-4-26b-a4b-it": Base_Ai_Cf_Google_Gemma_4_26B_A4B_IT;
12127
+ "@cf/google/gemma-4-26b-a4b-it": Base_Ai_Cf_Google_Gemma_4_26B_A4B_It;
12128
+ "@cf/nvidia/nemotron-speech-streaming-en-0.6b": Base_Ai_Cf_Nvidia_Nemotron_Speech_Streaming_En_0_6B;
11814
12129
  "@cf/moonshotai/kimi-k2.7-code": Base_Ai_Cf_Moonshotai_Kimi_K2_7_Code;
11815
12130
  "@cf/zai-org/glm-5.2": Base_Ai_Cf_Zai_Org_Glm_5_2;
11816
12131
  "@cf/moondream/moondream3.1-9B-A2B": Base_Ai_Cf_Moondream_Moondream3_1_9B_A2B;
11817
12132
  "@cf/deepseek-ai/deepseek-v4-flash-0731": Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Flash_0731;
11818
12133
  "@cf/deepseek-ai/deepseek-v4-pro-0813": Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Pro_0813;
11819
12134
  "@cf/qwen/qwen3.8-27b": Base_Ai_Cf_Qwen_Qwen3_8_27B;
12135
+ "@cf/zai-org/glm-5.3": Base_Ai_Cf_Zai_Org_Glm_5_3;
11820
12136
  "@cf/zai-org/glm-5.3-flash": Base_Ai_Cf_Zai_Org_Glm_5_3_Flash;
11821
12137
  }
11822
12138
  export type AiOptions = {
package/package.json CHANGED
@@ -7,5 +7,5 @@
7
7
  },
8
8
  "author": "Cloudflare Workers DevProd Team <workers-devprod@cloudflare.com> (https://workers.cloudflare.com)",
9
9
  "license": "MIT OR Apache-2.0",
10
- "version": "5.20260925.2"
10
+ "version": "5.20260926.1"
11
11
  }