@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.
@@ -4404,9 +4404,13 @@ export type LoopbackForExport<
4404
4404
  ? LoopbackServiceStub<InstanceType<T>>
4405
4405
  : T extends new (...args: any[]) => Rpc.DurableObjectBranded
4406
4406
  ? LoopbackDurableObjectClass<InstanceType<T>>
4407
- : T extends ExportedHandler<any, any, any>
4408
- ? LoopbackServiceStub<undefined>
4409
- : undefined;
4407
+ : T extends new (
4408
+ ...args: any[]
4409
+ ) => CloudflareWorkersModule.WorkflowEntrypoint<any, infer Params>
4410
+ ? Workflow<Params>
4411
+ : T extends ExportedHandler<any, any, any>
4412
+ ? LoopbackServiceStub<undefined>
4413
+ : undefined;
4410
4414
  export type LoopbackServiceStub<
4411
4415
  T extends Rpc.WorkerEntrypointBranded | undefined = undefined,
4412
4416
  > = Fetcher<T> &
@@ -6504,8 +6508,13 @@ export type WebSearchOptions = {
6504
6508
  search_context_size?: "low" | "medium" | "high";
6505
6509
  user_location?: WebSearchUserLocation;
6506
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.
6507
6516
  export type ChatTemplateKwargs = {
6508
- /** Whether to enable reasoning, enabled by default. */
6517
+ /** Whether to enable reasoning. Support and defaults depend on the model. */
6509
6518
  enable_thinking?: boolean;
6510
6519
  /** If false, preserves reasoning context between turns. */
6511
6520
  clear_thinking?: boolean;
@@ -6526,6 +6535,7 @@ export type ChatCompletionsCommonOptions = {
6526
6535
  parallel_tool_calls?: boolean;
6527
6536
  prediction?: PredictionContent;
6528
6537
  presence_penalty?: number | null;
6538
+ /** Reasoning effort. Supported levels depend on the model. */
6529
6539
  reasoning_effort?: "low" | "medium" | "high" | null;
6530
6540
  chat_template_kwargs?: ChatTemplateKwargs;
6531
6541
  response_format?: ResponseFormat;
@@ -10735,11 +10745,69 @@ export declare abstract class Base_Ai_Cf_Pipecat_Ai_Smart_Turn_V2 {
10735
10745
  postProcessedOutputs: Ai_Cf_Pipecat_Ai_Smart_Turn_V2_Output;
10736
10746
  }
10737
10747
  export declare abstract class Base_Ai_Cf_Openai_Gpt_Oss_120B {
10738
- 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
+ >;
10739
10778
  postProcessedOutputs: XOR<ResponsesOutput, ChatCompletionsOutput>;
10740
10779
  }
10741
10780
  export declare abstract class Base_Ai_Cf_Openai_Gpt_Oss_20B {
10742
- 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
+ >;
10743
10811
  postProcessedOutputs: XOR<ResponsesOutput, ChatCompletionsOutput>;
10744
10812
  }
10745
10813
  export interface Ai_Cf_Leonardo_Phoenix_1_0_Input {
@@ -11822,7 +11890,19 @@ export declare abstract class Base_Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B {
11822
11890
  postProcessedOutputs: Ai_Cf_Black_Forest_Labs_Flux_2_Klein_9B_Output;
11823
11891
  }
11824
11892
  export declare abstract class Base_Ai_Cf_Zai_Org_Glm_4_7_Flash {
11825
- 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
+ };
11826
11906
  postProcessedOutputs: ChatCompletionsOutput;
11827
11907
  }
11828
11908
  export declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_5 {
@@ -11830,23 +11910,168 @@ export declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_5 {
11830
11910
  postProcessedOutputs: ChatCompletionsOutput;
11831
11911
  }
11832
11912
  export declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_6 {
11833
- 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
+ };
11834
11932
  postProcessedOutputs: ChatCompletionsOutput;
11835
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
+ };
11836
11984
  export declare abstract class Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B {
11837
- inputs: ChatCompletionsInput;
11985
+ inputs: Ai_Cf_Nvidia_Nemotron_3_120B_A12B_Input;
11838
11986
  postProcessedOutputs: ChatCompletionsOutput;
11839
11987
  }
11840
- export declare abstract class Base_Ai_Cf_Google_Gemma_4_26B_A4B_IT {
11841
- 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;
11842
12008
  postProcessedOutputs: ChatCompletionsOutput;
11843
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
+ }
11844
12039
  export declare abstract class Base_Ai_Cf_Moonshotai_Kimi_K2_7_Code {
11845
- 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
+ };
11846
12053
  postProcessedOutputs: ChatCompletionsOutput;
11847
12054
  }
11848
12055
  export declare abstract class Base_Ai_Cf_Zai_Org_Glm_5_2 {
11849
- 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
+ };
11850
12075
  postProcessedOutputs: ChatCompletionsOutput;
11851
12076
  }
11852
12077
  export interface Ai_Cf_Moondream_Moondream3_1_9B_A2B_Input {
@@ -11983,26 +12208,119 @@ export declare abstract class Base_Ai_Cf_Moondream_Moondream3_1_9B_A2B {
11983
12208
  postProcessedOutputs: Ai_Cf_Moondream_Moondream3_1_9B_A2B_Output;
11984
12209
  }
11985
12210
  export declare abstract class Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Flash_0731 {
11986
- 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
+ };
11987
12230
  postProcessedOutputs: ChatCompletionsOutput;
11988
12231
  }
11989
12232
  export declare abstract class Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Pro_0813 {
11990
- 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
+ };
11991
12252
  postProcessedOutputs: ChatCompletionsOutput;
11992
12253
  }
11993
12254
  export declare abstract class Base_Ai_Cf_Qwen_Qwen3_8_27B {
11994
- 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
+ };
11995
12296
  postProcessedOutputs: ChatCompletionsOutput;
11996
12297
  }
11997
12298
  export declare abstract class Base_Ai_Cf_Zai_Org_Glm_5_3_Flash {
11998
- 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
+ };
11999
12318
  postProcessedOutputs: ChatCompletionsOutput;
12000
12319
  }
12001
12320
  export interface AiModels {
12002
12321
  "@cf/huggingface/distilbert-sst-2-int8": BaseAiTextClassification;
12003
12322
  "@cf/stabilityai/stable-diffusion-xl-base-1.0": BaseAiTextToImage;
12004
12323
  "@cf/runwayml/stable-diffusion-v1-5-inpainting": BaseAiTextToImage;
12005
- "@cf/runwayml/stable-diffusion-v1-5-img2img": BaseAiTextToImage;
12006
12324
  "@cf/lykon/dreamshaper-8-lcm": BaseAiTextToImage;
12007
12325
  "@cf/bytedance/stable-diffusion-xl-lightning": BaseAiTextToImage;
12008
12326
  "@cf/myshell-ai/melotts": BaseAiTextToSpeech;
@@ -12089,13 +12407,15 @@ export interface AiModels {
12089
12407
  "@cf/moonshotai/kimi-k2.5": Base_Ai_Cf_Moonshotai_Kimi_K2_5;
12090
12408
  "@cf/moonshotai/kimi-k2.6": Base_Ai_Cf_Moonshotai_Kimi_K2_6;
12091
12409
  "@cf/nvidia/nemotron-3-120b-a12b": Base_Ai_Cf_Nvidia_Nemotron_3_120B_A12B;
12092
- "@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;
12093
12412
  "@cf/moonshotai/kimi-k2.7-code": Base_Ai_Cf_Moonshotai_Kimi_K2_7_Code;
12094
12413
  "@cf/zai-org/glm-5.2": Base_Ai_Cf_Zai_Org_Glm_5_2;
12095
12414
  "@cf/moondream/moondream3.1-9B-A2B": Base_Ai_Cf_Moondream_Moondream3_1_9B_A2B;
12096
12415
  "@cf/deepseek-ai/deepseek-v4-flash-0731": Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Flash_0731;
12097
12416
  "@cf/deepseek-ai/deepseek-v4-pro-0813": Base_Ai_Cf_Deepseek_Ai_Deepseek_V4_Pro_0813;
12098
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;
12099
12419
  "@cf/zai-org/glm-5.3-flash": Base_Ai_Cf_Zai_Org_Glm_5_3_Flash;
12100
12420
  }
12101
12421
  export type AiOptions = {