@cloudflare/workers-types 5.20260925.1 → 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
@@ -4122,9 +4122,13 @@ type LoopbackForExport<
4122
4122
  ? LoopbackServiceStub<InstanceType<T>>
4123
4123
  : T extends new (...args: any[]) => Rpc.DurableObjectBranded
4124
4124
  ? LoopbackDurableObjectClass<InstanceType<T>>
4125
- : T extends ExportedHandler<any, any, any>
4126
- ? LoopbackServiceStub<undefined>
4127
- : undefined;
4125
+ : T extends new (
4126
+ ...args: any[]
4127
+ ) => CloudflareWorkersModule.WorkflowEntrypoint<any, infer Params>
4128
+ ? Workflow<Params>
4129
+ : T extends ExportedHandler<any, any, any>
4130
+ ? LoopbackServiceStub<undefined>
4131
+ : undefined;
4128
4132
  type LoopbackServiceStub<
4129
4133
  T extends Rpc.WorkerEntrypointBranded | undefined = undefined,
4130
4134
  > = Fetcher<T> &
@@ -6210,8 +6214,13 @@ type WebSearchOptions = {
6210
6214
  search_context_size?: "low" | "medium" | "high";
6211
6215
  user_location?: WebSearchUserLocation;
6212
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.
6213
6222
  type ChatTemplateKwargs = {
6214
- /** Whether to enable reasoning, enabled by default. */
6223
+ /** Whether to enable reasoning. Support and defaults depend on the model. */
6215
6224
  enable_thinking?: boolean;
6216
6225
  /** If false, preserves reasoning context between turns. */
6217
6226
  clear_thinking?: boolean;
@@ -6232,6 +6241,7 @@ type ChatCompletionsCommonOptions = {
6232
6241
  parallel_tool_calls?: boolean;
6233
6242
  prediction?: PredictionContent;
6234
6243
  presence_penalty?: number | null;
6244
+ /** Reasoning effort. Supported levels depend on the model. */
6235
6245
  reasoning_effort?: "low" | "medium" | "high" | null;
6236
6246
  chat_template_kwargs?: ChatTemplateKwargs;
6237
6247
  response_format?: ResponseFormat;
@@ -10440,11 +10450,69 @@ declare abstract class Base_Ai_Cf_Pipecat_Ai_Smart_Turn_V2 {
10440
10450
  postProcessedOutputs: Ai_Cf_Pipecat_Ai_Smart_Turn_V2_Output;
10441
10451
  }
10442
10452
  declare abstract class Base_Ai_Cf_Openai_Gpt_Oss_120B {
10443
- 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
+ >;
10444
10483
  postProcessedOutputs: XOR<ResponsesOutput, ChatCompletionsOutput>;
10445
10484
  }
10446
10485
  declare abstract class Base_Ai_Cf_Openai_Gpt_Oss_20B {
10447
- 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
+ >;
10448
10516
  postProcessedOutputs: XOR<ResponsesOutput, ChatCompletionsOutput>;
10449
10517
  }
10450
10518
  interface Ai_Cf_Leonardo_Phoenix_1_0_Input {
@@ -11527,7 +11595,19 @@ declare abstract class Base_Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B {
11527
11595
  postProcessedOutputs: Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B_Output;
11528
11596
  }
11529
11597
  declare abstract class Base_Ai_Cf_Zai_Org_Glm_4_7_Flash {
11530
- 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
+ };
11531
11611
  postProcessedOutputs: ChatCompletionsOutput;
11532
11612
  }
11533
11613
  declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_5 {
@@ -11535,23 +11615,168 @@ declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_5 {
11535
11615
  postProcessedOutputs: ChatCompletionsOutput;
11536
11616
  }
11537
11617
  declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_6 {
11538
- 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
+ };
11539
11637
  postProcessedOutputs: ChatCompletionsOutput;
11540
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
+ };
11541
11689
  declare abstract class Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B {
11542
- inputs: ChatCompletionsInput;
11690
+ inputs: Ai_Cf_Nvidia_Nemotron_3_120B_A12B_Input;
11543
11691
  postProcessedOutputs: ChatCompletionsOutput;
11544
11692
  }
11545
- declare abstract class Base_Ai_Cf_Google_Gemma_4_26B_A4B_IT {
11546
- 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;
11547
11713
  postProcessedOutputs: ChatCompletionsOutput;
11548
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
+ }
11549
11744
  declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_7_Code {
11550
- 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
+ };
11551
11758
  postProcessedOutputs: ChatCompletionsOutput;
11552
11759
  }
11553
11760
  declare abstract class Base_Ai_Cf_Zai_Org_Glm_5_2 {
11554
- 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
+ };
11555
11780
  postProcessedOutputs: ChatCompletionsOutput;
11556
11781
  }
11557
11782
  interface Ai_Cf_Moondream_Moondream3_1_9B_A2B_Input {
@@ -11688,26 +11913,119 @@ declare abstract class Base_Ai_Cf_Moondream_Moondream3_1_9B_A2B {
11688
11913
  postProcessedOutputs: Ai_Cf_Moondream_Moondream3_1_9B_A2B_Output;
11689
11914
  }
11690
11915
  declare abstract class Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Flash_0731 {
11691
- 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
+ };
11692
11935
  postProcessedOutputs: ChatCompletionsOutput;
11693
11936
  }
11694
11937
  declare abstract class Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Pro_0813 {
11695
- 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
+ };
11696
11957
  postProcessedOutputs: ChatCompletionsOutput;
11697
11958
  }
11698
11959
  declare abstract class Base_Ai_Cf_Qwen_Qwen3_8_27B {
11699
- 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
+ };
11700
12001
  postProcessedOutputs: ChatCompletionsOutput;
11701
12002
  }
11702
12003
  declare abstract class Base_Ai_Cf_Zai_Org_Glm_5_3_Flash {
11703
- 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
+ };
11704
12023
  postProcessedOutputs: ChatCompletionsOutput;
11705
12024
  }
11706
12025
  interface AiModels {
11707
12026
  "@cf/huggingface/distilbert-sst-2-int8": BaseAiTextClassification;
11708
12027
  "@cf/stabilityai/stable-diffusion-xl-base-1.0": BaseAiTextToImage;
11709
12028
  "@cf/runwayml/stable-diffusion-v1-5-inpainting": BaseAiTextToImage;
11710
- "@cf/runwayml/stable-diffusion-v1-5-img2img": BaseAiTextToImage;
11711
12029
  "@cf/lykon/dreamshaper-8-lcm": BaseAiTextToImage;
11712
12030
  "@cf/bytedance/stable-diffusion-xl-lightning": BaseAiTextToImage;
11713
12031
  "@cf/myshell-ai/melotts": BaseAiTextToSpeech;
@@ -11794,13 +12112,15 @@ interface AiModels {
11794
12112
  "@cf/moonshotai/kimi-k2.5": Base_Ai_Cf_Moonshotai_Kimi_K2_5;
11795
12113
  "@cf/moonshotai/kimi-k2.6": Base_Ai_Cf_Moonshotai_Kimi_K2_6;
11796
12114
  "@cf/nvidia/nemotron-3-120b-a12b": Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B;
11797
- "@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;
11798
12117
  "@cf/moonshotai/kimi-k2.7-code": Base_Ai_Cf_Moonshotai_Kimi_K2_7_Code;
11799
12118
  "@cf/zai-org/glm-5.2": Base_Ai_Cf_Zai_Org_Glm_5_2;
11800
12119
  "@cf/moondream/moondream3.1-9B-A2B": Base_Ai_Cf_Moondream_Moondream3_1_9B_A2B;
11801
12120
  "@cf/deepseek-ai/deepseek-v4-flash-0731": Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Flash_0731;
11802
12121
  "@cf/deepseek-ai/deepseek-v4-pro-0813": Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Pro_0813;
11803
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;
11804
12124
  "@cf/zai-org/glm-5.3-flash": Base_Ai_Cf_Zai_Org_Glm_5_3_Flash;
11805
12125
  }
11806
12126
  type AiOptions = {