@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.ts CHANGED
@@ -4131,9 +4131,13 @@ export type LoopbackForExport<
4131
4131
  ? LoopbackServiceStub<InstanceType<T>>
4132
4132
  : T extends new (...args: any[]) => Rpc.DurableObjectBranded
4133
4133
  ? LoopbackDurableObjectClass<InstanceType<T>>
4134
- : T extends ExportedHandler<any, any, any>
4135
- ? LoopbackServiceStub<undefined>
4136
- : undefined;
4134
+ : T extends new (
4135
+ ...args: any[]
4136
+ ) => CloudflareWorkersModule.WorkflowEntrypoint<any, infer Params>
4137
+ ? Workflow<Params>
4138
+ : T extends ExportedHandler<any, any, any>
4139
+ ? LoopbackServiceStub<undefined>
4140
+ : undefined;
4137
4141
  export type LoopbackServiceStub<
4138
4142
  T extends Rpc.WorkerEntrypointBranded | undefined = undefined,
4139
4143
  > = Fetcher<T> &
@@ -6221,8 +6225,13 @@ export type WebSearchOptions = {
6221
6225
  search_context_size?: "low" | "medium" | "high";
6222
6226
  user_location?: WebSearchUserLocation;
6223
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.
6224
6233
  export type ChatTemplateKwargs = {
6225
- /** Whether to enable reasoning, enabled by default. */
6234
+ /** Whether to enable reasoning. Support and defaults depend on the model. */
6226
6235
  enable_thinking?: boolean;
6227
6236
  /** If false, preserves reasoning context between turns. */
6228
6237
  clear_thinking?: boolean;
@@ -6243,6 +6252,7 @@ export type ChatCompletionsCommonOptions = {
6243
6252
  parallel_tool_calls?: boolean;
6244
6253
  prediction?: PredictionContent;
6245
6254
  presence_penalty?: number | null;
6255
+ /** Reasoning effort. Supported levels depend on the model. */
6246
6256
  reasoning_effort?: "low" | "medium" | "high" | null;
6247
6257
  chat_template_kwargs?: ChatTemplateKwargs;
6248
6258
  response_format?: ResponseFormat;
@@ -10452,11 +10462,69 @@ export declare abstract class Base_Ai_Cf_Pipecat_Ai_Smart_Turn_V2 {
10452
10462
  postProcessedOutputs: Ai_Cf_Pipecat_Ai_Smart_Turn_V2_Output;
10453
10463
  }
10454
10464
  export declare abstract class Base_Ai_Cf_Openai_Gpt_Oss_120B {
10455
- 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
+ >;
10456
10495
  postProcessedOutputs: XOR<ResponsesOutput, ChatCompletionsOutput>;
10457
10496
  }
10458
10497
  export declare abstract class Base_Ai_Cf_Openai_Gpt_Oss_20B {
10459
- 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
+ >;
10460
10528
  postProcessedOutputs: XOR<ResponsesOutput, ChatCompletionsOutput>;
10461
10529
  }
10462
10530
  export interface Ai_Cf_Leonardo_Phoenix_1_0_Input {
@@ -11539,7 +11607,19 @@ export declare abstract class Base_Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B {
11539
11607
  postProcessedOutputs: Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B_Output;
11540
11608
  }
11541
11609
  export declare abstract class Base_Ai_Cf_Zai_Org_Glm_4_7_Flash {
11542
- 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
+ };
11543
11623
  postProcessedOutputs: ChatCompletionsOutput;
11544
11624
  }
11545
11625
  export declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_5 {
@@ -11547,23 +11627,168 @@ export declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_5 {
11547
11627
  postProcessedOutputs: ChatCompletionsOutput;
11548
11628
  }
11549
11629
  export declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_6 {
11550
- 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
+ };
11551
11649
  postProcessedOutputs: ChatCompletionsOutput;
11552
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
+ };
11553
11701
  export declare abstract class Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B {
11554
- inputs: ChatCompletionsInput;
11702
+ inputs: Ai_Cf_Nvidia_Nemotron_3_120B_A12B_Input;
11555
11703
  postProcessedOutputs: ChatCompletionsOutput;
11556
11704
  }
11557
- export declare abstract class Base_Ai_Cf_Google_Gemma_4_26B_A4B_IT {
11558
- 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;
11559
11725
  postProcessedOutputs: ChatCompletionsOutput;
11560
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
+ }
11561
11756
  export declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_7_Code {
11562
- 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
+ };
11563
11770
  postProcessedOutputs: ChatCompletionsOutput;
11564
11771
  }
11565
11772
  export declare abstract class Base_Ai_Cf_Zai_Org_Glm_5_2 {
11566
- 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
+ };
11567
11792
  postProcessedOutputs: ChatCompletionsOutput;
11568
11793
  }
11569
11794
  export interface Ai_Cf_Moondream_Moondream3_1_9B_A2B_Input {
@@ -11700,26 +11925,119 @@ export declare abstract class Base_Ai_Cf_Moondream_Moondream3_1_9B_A2B {
11700
11925
  postProcessedOutputs: Ai_Cf_Moondream_Moondream3_1_9B_A2B_Output;
11701
11926
  }
11702
11927
  export declare abstract class Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Flash_0731 {
11703
- 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
+ };
11704
11947
  postProcessedOutputs: ChatCompletionsOutput;
11705
11948
  }
11706
11949
  export declare abstract class Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Pro_0813 {
11707
- 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
+ };
11708
11969
  postProcessedOutputs: ChatCompletionsOutput;
11709
11970
  }
11710
11971
  export declare abstract class Base_Ai_Cf_Qwen_Qwen3_8_27B {
11711
- 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
+ };
11712
12013
  postProcessedOutputs: ChatCompletionsOutput;
11713
12014
  }
11714
12015
  export declare abstract class Base_Ai_Cf_Zai_Org_Glm_5_3_Flash {
11715
- 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
+ };
11716
12035
  postProcessedOutputs: ChatCompletionsOutput;
11717
12036
  }
11718
12037
  export interface AiModels {
11719
12038
  "@cf/huggingface/distilbert-sst-2-int8": BaseAiTextClassification;
11720
12039
  "@cf/stabilityai/stable-diffusion-xl-base-1.0": BaseAiTextToImage;
11721
12040
  "@cf/runwayml/stable-diffusion-v1-5-inpainting": BaseAiTextToImage;
11722
- "@cf/runwayml/stable-diffusion-v1-5-img2img": BaseAiTextToImage;
11723
12041
  "@cf/lykon/dreamshaper-8-lcm": BaseAiTextToImage;
11724
12042
  "@cf/bytedance/stable-diffusion-xl-lightning": BaseAiTextToImage;
11725
12043
  "@cf/myshell-ai/melotts": BaseAiTextToSpeech;
@@ -11806,13 +12124,15 @@ export interface AiModels {
11806
12124
  "@cf/moonshotai/kimi-k2.5": Base_Ai_Cf_Moonshotai_Kimi_K2_5;
11807
12125
  "@cf/moonshotai/kimi-k2.6": Base_Ai_Cf_Moonshotai_Kimi_K2_6;
11808
12126
  "@cf/nvidia/nemotron-3-120b-a12b": Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B;
11809
- "@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;
11810
12129
  "@cf/moonshotai/kimi-k2.7-code": Base_Ai_Cf_Moonshotai_Kimi_K2_7_Code;
11811
12130
  "@cf/zai-org/glm-5.2": Base_Ai_Cf_Zai_Org_Glm_5_2;
11812
12131
  "@cf/moondream/moondream3.1-9B-A2B": Base_Ai_Cf_Moondream_Moondream3_1_9B_A2B;
11813
12132
  "@cf/deepseek-ai/deepseek-v4-flash-0731": Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Flash_0731;
11814
12133
  "@cf/deepseek-ai/deepseek-v4-pro-0813": Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Pro_0813;
11815
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;
11816
12136
  "@cf/zai-org/glm-5.3-flash": Base_Ai_Cf_Zai_Org_Glm_5_3_Flash;
11817
12137
  }
11818
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.1"
10
+ "version": "5.20260926.1"
11
11
  }