From 72f3037ebe1eb4e14aa7b6cddd46a2c44663fbc9 Mon Sep 17 00:00:00 2001 From: flemming-it Date: Thu, 12 Nov 2026 15:49:50 +0100 Subject: [PATCH] feat: max_tokens and repeat_penalty inputs, truncated and stop_reason outputs, 0.4.0 A model caught in a repetition loop wrote until the flow's 300 s timeout. max_tokens bounds the answer on every wire (Ollama num_predict, OpenAI max_tokens, Anthropic max_tokens), and truncated tells the caller whether the answer stopped at that limit. repeat_penalty goes to Ollama and vLLM and is refused where the backend has no such setting. Signed-off-by: flemming-it --- Cargo.lock | 2 +- Cargo.toml | 2 +- MODULE.de.md | 8 +- MODULE.md | 8 +- module.wasm | Bin 346349 -> 350212 bytes module.yaml | 63 +++++++++++- src/lib.rs | 9 ++ src/llm.rs | 278 ++++++++++++++++++++++++++++++++++++++++++++++++++- 8 files changed, 361 insertions(+), 9 deletions(-) diff --git a/Cargo.lock b/Cargo.lock index e2d8ab4..7fe827e 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -138,7 +138,7 @@ checksum = "6cc46bac87ef8093eed6f272babb833b6443374399985ac8ed28471ee0918545" [[package]] name = "llm_chat" -version = "0.3.1" +version = "0.4.0" dependencies = [ "chain-module-sdk", "serde", diff --git a/Cargo.toml b/Cargo.toml index caceacd..9ecd984 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -5,7 +5,7 @@ [package] name = "llm_chat" -version = "0.3.1" +version = "0.4.0" edition = "2024" license = "Apache-2.0" publish = false diff --git a/MODULE.de.md b/MODULE.de.md index 13b7e6c..bd68bbf 100644 --- a/MODULE.de.md +++ b/MODULE.de.md @@ -10,7 +10,7 @@ die Anthropic Messages API. ## Capability -- `llm.chat@0.3.0` +- `llm.chat@0.4.0` ## Eingaben @@ -22,6 +22,8 @@ die Anthropic Messages API. | `api_key` | text | Optionaler API-Key. Erscheint nie in Ausgaben, Logs oder Events. | | `keep_alive` | text | Nur Ollama: wie lange der Server das Modell nach dieser Anfrage geladen lässt (`4h`, `30m`, `-1` = unbegrenzt). Leer = Server-Voreinstellung, die nach fünf Minuten entlädt. Mit anderer `api` abgelehnt. | | `think` | text | `true` oder `false`: ob ein Reasoning-Modell seine Denkphase durchläuft. Leer = Voreinstellung des Servers (Ollama lässt Modelle wie qwen3 denken). Ollama bekommt `think`, vLLM `chat_template_kwargs.enable_thinking`; im OpenAI-Format abgelehnt; Anthropic nimmt nur `false`. Gemessen mit Ollama 0.40.9: `qwen3.8:27b` und `gemma4:26b` halten `false` ein; `qwen3:30b-a3b` denkt trotzdem, das Denken steht dann in der Antwort und endet mit ``. | +| `max_tokens` | text | Obergrenze für die Länge der Antwort in Token (ganze Zahl ab 1). Ollama bekommt `options.num_predict`, das OpenAI-Format `max_tokens`, Anthropic `max_tokens` (4096, wenn leer). Leer = keine Grenze bei Ollama und im OpenAI-Format. Ohne Grenze schreibt ein Modell in einer Wiederholungsschleife bis zur Zeitgrenze des Ablaufs; mit `num_predict: 400` brach `qwen3.8:27b` unter Ollama 0.40.9 eine solche Schleife nach 39 s ab. | +| `repeat_penalty` | text | Abschlag auf wiederholte Token, 1.0 = neutral. Ollama bekommt `options.repeat_penalty`, vLLM `repetition_penalty`; im OpenAI-Format und bei Anthropic abgelehnt. | | `system_prompt` | text | Optionale System-Nachricht. Leer = Default des Modells. | | `api` | text | Optionales Wire-Format: `ollama` (Default), `openai`, `anthropic`. | @@ -31,13 +33,15 @@ die Anthropic Messages API. | ----------- | ----------------------------------------- | ---------------------------------- | ------------------------------------------------------------ | | `ollama` | `http://localhost:11434/api/chat` | `Authorization: Bearer` (optional) | Verhalten wie v0.1.0, unverändert. Modell-Digest-Probe via `/api/show`. | | `openai` | `https://.../v1/chat/completions` | `Authorization: Bearer` | OpenAI-Chat-Completions-Format — sprechen auch vLLM und die meisten selbst gehosteten Inferenz-Server. | -| `anthropic` | `https://api.anthropic.com/v1/messages` | `x-api-key` + `anthropic-version` | Messages API: `system` ist Top-Level-Feld; `max_tokens` ist Pflicht und steht fest auf 4096. | +| `anthropic` | `https://api.anthropic.com/v1/messages` | `x-api-key` + `anthropic-version` | Messages API: `system` ist Top-Level-Feld; `max_tokens` ist Pflicht; `max_tokens` setzt es, sonst 4096. | ## Ausgaben | Name | Typ | Beschreibung | | ---------------- | ---- | --------------------------------------------------------------------- | | `response` | text | Die Antwort des Assistants als Plain-Text. | +| `truncated` | text | `true`, wenn die Antwort an der Längengrenze endete, `false`, wenn das Modell fertig war. Leer, wenn das Backend keinen Grund nannte. Eine abgeschnittene Antwort wird trotzdem geliefert; der Ablauf entscheidet, was damit geschieht. | +| `stop_reason` | text | Der Grund des Backends: Ollama `done_reason`, OpenAI `finish_reason`, Anthropic `stop_reason`. Leer, wenn er fehlt. | | `model_endpoint` | text | URL, gegen die die Antwort erzeugt wurde. | | `model_name` | text | Modell-ID wie an die LLM-API gesendet. | | `model_digest` | text | SHA-256-Digest des bedienenden Ollama-Modells. Leer bei `openai`/`anthropic` — diese APIs bieten keinen Digest; das Feld bleibt leer statt erfunden. | diff --git a/MODULE.md b/MODULE.md index f697dd1..a1aaa32 100644 --- a/MODULE.md +++ b/MODULE.md @@ -10,7 +10,7 @@ Anthropic Messages API. ## Capability -- `llm.chat@0.3.0` +- `llm.chat@0.4.0` ## Inputs @@ -22,6 +22,8 @@ Anthropic Messages API. | `api_key` | text | Optional API key. Never appears in outputs, logs, or events. | | `keep_alive` | text | Ollama only: how long the server keeps the model resident after this request (`4h`, `30m`, `-1` = indefinitely). Empty = server default, which unloads after five minutes. Refused with any other `api`. | | `think` | text | `true` or `false`: whether a reasoning model runs its thinking phase. Empty = server default (Ollama lets qwen3-type models think). Ollama gets `think`, vLLM `chat_template_kwargs.enable_thinking`; refused on the OpenAI wire; Anthropic takes `false` only. Measured on Ollama 0.40.9: `qwen3.8:27b` and `gemma4:26b` honour `false`; `qwen3:30b-a3b` thinks anyway and its thinking then arrives inside the reply, ending with ``. | +| `max_tokens` | text | Upper bound on the answer length in tokens (whole number, at least 1). Ollama gets `options.num_predict`, the OpenAI wire `max_tokens`, Anthropic `max_tokens` (default 4096 when empty). Empty = no limit on Ollama and the OpenAI wire. Without a limit, a model caught in a repetition loop writes until the flow's timeout; with `num_predict: 400`, `qwen3.8:27b` on Ollama 0.40.9 stopped such a loop after 39 s. | +| `repeat_penalty` | text | Penalty on repeated tokens, 1.0 = neutral. Ollama gets `options.repeat_penalty`, vLLM `repetition_penalty`; refused on the OpenAI wire and for Anthropic. | | `system_prompt` | text | Optional system message. Empty = use the model's default. | | `api` | text | Optional wire format: `ollama` (default), `openai`, `anthropic`. | @@ -31,13 +33,15 @@ Anthropic Messages API. | ----------- | --------------------------------------------- | ---------------------------------- | ------------------------------------------------------------ | | `ollama` | `http://localhost:11434/api/chat` | `Authorization: Bearer` (optional) | v0.1.0 behavior, unchanged. Model-digest probe via `/api/show`. | | `openai` | `https://.../v1/chat/completions` | `Authorization: Bearer` | OpenAI Chat Completions format — also spoken by vLLM and most self-hosted inference servers. | -| `anthropic` | `https://api.anthropic.com/v1/messages` | `x-api-key` + `anthropic-version` | Messages API: `system` is a top-level field; `max_tokens` is mandatory and defaults to 4096. | +| `anthropic` | `https://api.anthropic.com/v1/messages` | `x-api-key` + `anthropic-version` | Messages API: `system` is a top-level field; `max_tokens` is mandatory; `max_tokens` sets it, default 4096. | ## Outputs | Name | Type | Description | | ---------------- | ---- | ------------------------------------------------------------------- | | `response` | text | The assistant's plain-text reply. | +| `truncated` | text | `true` when the answer stopped at the length limit, `false` when the model finished. Empty when the backend gave no stop reason. A truncated answer is still returned; the flow decides what to do with it. | +| `stop_reason` | text | The backend's own reason: Ollama `done_reason`, OpenAI `finish_reason`, Anthropic `stop_reason`. Empty when absent. | | `model_endpoint` | text | The endpoint the response was generated against. | | `model_name` | text | The model identifier as supplied to the LLM API. | | `model_digest` | text | SHA-256 digest of the served Ollama model. Empty for `openai`/`anthropic` — those APIs expose no digest; the field is left empty rather than fabricated. | diff --git a/module.wasm b/module.wasm index c600c7fa4672339d35c29a5f1c0f201c968b6670..ef73b6f5013a1e1860d0ce43091aa24562f60ab7 100644 GIT binary patch delta 64856 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 delta 61472 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 diff --git a/module.yaml b/module.yaml index 62ea8af..3d6b97d 100644 --- a/module.yaml +++ b/module.yaml @@ -1,12 +1,12 @@ schema_version: 3 provider: chain name: llm-chat -version: 0.3.1 +version: 0.4.0 # Capability provided by this module. provides: - capability: llm.chat - version: 0.3.1 + version: 0.4.0 # Declared inputs in verbose v3 form. Studio renders the # description in the active locale as a tooltip on each @@ -108,6 +108,39 @@ inputs: das einen Lauf wiederholbar. Nur Ollama und das OpenAI-Format; Anthropic kennt keinen Seed und lehnt den Eingang ab. + max_tokens: + type: text + description: + en: | + Upper bound on the answer length in tokens, a whole number of + at least 1. A model caught in a repetition loop otherwise + writes until the flow's timeout. Ollama receives + options.num_predict, the OpenAI wire max_tokens, Anthropic + max_tokens (default 4096 there when empty). Empty leaves no + limit on Ollama and the OpenAI wire. Whether the answer + stopped at the limit is reported in the output truncated. + de: | + Obergrenze für die Länge der Antwort in Token, ganze Zahl ab + 1. Ein Modell in einer Wiederholungsschleife schreibt sonst + bis zur Zeitgrenze des Ablaufs. Ollama bekommt + options.num_predict, das OpenAI-Format max_tokens, Anthropic + max_tokens (dort 4096, wenn leer). Leer heißt bei Ollama und + im OpenAI-Format keine Grenze. Ob die Antwort an der Grenze + endete, steht in der Ausgabe truncated. + repeat_penalty: + type: text + description: + en: | + Penalty on repeated tokens, a number; 1.0 is neutral, values + such as 1.1 make loops less likely. Ollama receives + options.repeat_penalty, vLLM repetition_penalty. The OpenAI + wire and Anthropic have no such setting and refuse the input. + de: | + Abschlag auf wiederholte Token, eine Zahl; 1.0 ist neutral, + Werte wie 1.1 machen Schleifen seltener. Ollama bekommt + options.repeat_penalty, vLLM repetition_penalty. Das + OpenAI-Format und Anthropic kennen die Einstellung nicht und + lehnen den Eingang ab. keep_alive: type: text description: @@ -167,6 +200,32 @@ outputs: description: en: The assistant's plain-text reply. de: Die Klartext-Antwort des Modells. + truncated: + type: text + description: + en: | + "true" when the answer stopped at the length limit + (max_tokens) instead of where the model finished, "false" + when the model finished. Empty when the backend gave no + stop reason. + de: | + "true", wenn die Antwort an der Längengrenze (max_tokens) + endete statt dort, wo das Modell fertig war, "false", wenn + das Modell fertig war. Leer, wenn das Backend keinen Grund + für das Ende nannte. + stop_reason: + type: text + description: + en: | + Why the backend stopped writing, in its own words: Ollama + done_reason (stop, length), the OpenAI wire finish_reason + (stop, length), Anthropic stop_reason (end_turn, + max_tokens, ...). Empty when the answer did not say. + de: | + Warum das Backend aufhörte, in seinen eigenen Worten: Ollama + done_reason (stop, length), das OpenAI-Format finish_reason + (stop, length), Anthropic stop_reason (end_turn, max_tokens + u. a.). Leer, wenn die Antwort es nicht angab. model_endpoint: type: text description: diff --git a/src/lib.rs b/src/lib.rs index d4a432d..9c5749a 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -48,6 +48,8 @@ pub fn invoke(_ctx: Context, inputs: Inputs) -> Result { let top_p = sampling_input("top_p"); let top_k = sampling_input("top_k"); let seed = sampling_input("seed"); + let max_tokens = sampling_input("max_tokens"); + let repeat_penalty = sampling_input("repeat_penalty"); // Refused rather than ignored for any other wire format. The // whole point of the input is an expectation about the server // ("the model stays loaded"); silently dropping it would leave @@ -77,6 +79,8 @@ pub fn invoke(_ctx: Context, inputs: Inputs) -> Result { top_p: &top_p, top_k: &top_k, seed: &seed, + max_tokens: &max_tokens, + repeat_penalty: &repeat_penalty, }, }; let result = crate::llm::chat_with_identity(&client, ¶ms) @@ -89,8 +93,13 @@ pub fn invoke(_ctx: Context, inputs: Inputs) -> Result { Some((prompt, completion)) => (prompt.to_string(), completion.to_string()), None => (String::new(), String::new()), }; + // Empty where the backend gave no stop reason: "false" would + // claim the answer is complete without anyone having said so. + let truncated = result.truncated.map(|t| t.to_string()).unwrap_or_default(); Ok(Outputs::new() .with_text("response", result.response) + .with_text("truncated", truncated) + .with_text("stop_reason", result.stop_reason.unwrap_or_default()) .with_text("model_endpoint", endpoint) .with_text("model_name", model) .with_text("model_digest", result.model_digest.unwrap_or_default()) diff --git a/src/llm.rs b/src/llm.rs index 8fc1d6b..e5712c4 100644 --- a/src/llm.rs +++ b/src/llm.rs @@ -119,6 +119,12 @@ pub struct Sampling<'a> { pub top_p: &'a str, pub top_k: &'a str, pub seed: &'a str, + /// Upper bound on the answer length in tokens. A model caught in + /// a repetition loop otherwise writes until the flow's timeout. + pub max_tokens: &'a str, + /// Penalty on repeated tokens (Ollama `repeat_penalty`, vLLM + /// `repetition_penalty`; 1.0 is neutral). + pub repeat_penalty: &'a str, } /// One parsed sampling value. Numbers only; a value that is not a @@ -160,6 +166,10 @@ struct OllamaOptions { top_k: Option, #[serde(skip_serializing_if = "Option::is_none")] seed: Option, + #[serde(skip_serializing_if = "Option::is_none")] + num_predict: Option, + #[serde(skip_serializing_if = "Option::is_none")] + repeat_penalty: Option, } impl OllamaOptions { @@ -168,6 +178,24 @@ impl OllamaOptions { && self.top_p.is_none() && self.top_k.is_none() && self.seed.is_none() + && self.num_predict.is_none() + && self.repeat_penalty.is_none() + } +} + +/// Parse `max_tokens`: a whole number of at least 1. Zero or a +/// negative count would mean "no answer" or, for Ollama, "no limit", +/// and neither is what a caller writing a limit asks for. +fn parse_max_tokens(raw: &str) -> Result, LlmError> { + let raw = raw.trim(); + if raw.is_empty() { + return Ok(None); + } + match raw.parse::() { + Ok(n) if n >= 1 => Ok(Some(n)), + _ => Err(LlmError::UnsupportedApi(format!( + "max_tokens must be a whole number of at least 1, got {raw:?}" + ))), } } @@ -247,6 +275,11 @@ struct OpenAiRequest<'a> { top_p: Option, #[serde(skip_serializing_if = "Option::is_none")] seed: Option, + #[serde(skip_serializing_if = "Option::is_none")] + max_tokens: Option, + /// vLLM only: an extra sampling parameter of vLLM's server. + #[serde(skip_serializing_if = "Option::is_none")] + repetition_penalty: Option, /// vLLM only: passed to the chat template, where qwen3-type /// templates read `enable_thinking`. #[serde(skip_serializing_if = "Option::is_none")] @@ -310,6 +343,9 @@ pub fn build_ollama_body(p: &ChatParams) -> Result { top_p: parse_sampling("top_p", p.sampling.top_p, false)?, top_k: parse_sampling("top_k", p.sampling.top_k, true)?, seed: parse_sampling("seed", p.sampling.seed, true)?, + num_predict: parse_max_tokens(p.sampling.max_tokens)? + .map(|n| SamplingValue::Int(i64::from(n))), + repeat_penalty: parse_sampling("repeat_penalty", p.sampling.repeat_penalty, false)?, }; let req = OllamaRequest { model: p.model, @@ -351,6 +387,16 @@ pub fn build_openai_body(p: &ChatParams) -> Result { )); } }; + // OpenAI's own server has no repetition penalty with this + // meaning (frequency_penalty counts differently); vLLM has one. + let repetition_penalty = parse_sampling("repeat_penalty", p.sampling.repeat_penalty, false)?; + if repetition_penalty.is_some() && p.api != Api::Vllm { + return Err(LlmError::UnsupportedApi( + "repeat_penalty is not part of the OpenAI chat wire; use \ + api: ollama or vllm, or drop the input" + .to_string(), + )); + } let req = OpenAiRequest { model: p.model, messages: build_messages(p), @@ -358,6 +404,8 @@ pub fn build_openai_body(p: &ChatParams) -> Result { temperature: parse_sampling("temperature", p.sampling.temperature, false)?, top_p: parse_sampling("top_p", p.sampling.top_p, false)?, seed: parse_sampling("seed", p.sampling.seed, true)?, + max_tokens: parse_max_tokens(p.sampling.max_tokens)?, + repetition_penalty, chat_template_kwargs, }; Ok(serde_json::to_string(&req).unwrap_or_else(|_| String::from("{}"))) @@ -388,9 +436,17 @@ pub fn build_anthropic_body(p: &ChatParams) -> Result { .to_string(), )); } + if !p.sampling.repeat_penalty.trim().is_empty() { + return Err(LlmError::UnsupportedApi( + "repeat_penalty is not part of the Anthropic Messages API; use \ + api: ollama or vllm, or drop the input" + .to_string(), + )); + } let req = AnthropicRequest { model: p.model, - max_tokens: ANTHROPIC_DEFAULT_MAX_TOKENS, + max_tokens: parse_max_tokens(p.sampling.max_tokens)? + .unwrap_or(ANTHROPIC_DEFAULT_MAX_TOKENS), system: if p.system_prompt.is_empty() { None } else { @@ -454,6 +510,33 @@ pub struct ChatWithIdentity { /// (prompt, completion). `None` where the answer carries no /// count, which is honest about a number nobody measured. pub tokens: Option<(u64, u64)>, + /// Why the backend stopped writing, as the backend said it + /// (`stop`, `length`, `end_turn`, `max_tokens`, ...). `None` + /// where the answer did not say. + pub stop_reason: Option, + /// Whether the answer ended at the length limit rather than + /// where the model finished. `None` where the backend gave no + /// reason, because "not cut off" would be a guess. + pub truncated: Option, +} + +/// The stop reason of one answer and whether it means "cut off at +/// the length limit". Ollama writes `done_reason` (`stop`, `length`), +/// the OpenAI shape `choices[0].finish_reason` (`stop`, `length`), +/// Anthropic `stop_reason` (`end_turn`, `max_tokens`, ...). +pub fn extract_stop(api: Api, body: &str) -> (Option, Option) { + let Ok(v) = serde_json::from_str::(body) else { + return (None, None); + }; + let (reason, length_word) = match api { + Api::Ollama => (v.get("done_reason"), "length"), + Api::Openai | Api::Vllm => (v.pointer("/choices/0/finish_reason"), "length"), + Api::Anthropic => (v.get("stop_reason"), "max_tokens"), + }; + match reason.and_then(|r| r.as_str()).filter(|r| !r.is_empty()) { + Some(r) => (Some(r.to_string()), Some(r == length_word)), + None => (None, None), + } } /// The token counts of one answer, per wire format. @@ -522,10 +605,13 @@ pub fn chat_with_identity( Api::Openai | Api::Vllm | Api::Anthropic => None, }; let tokens = extract_tokens(p.api, &response_body); + let (stop_reason, truncated) = extract_stop(p.api, &response_body); Ok(ChatWithIdentity { response, model_digest, tokens, + stop_reason, + truncated, }) } @@ -1350,3 +1436,193 @@ mod think_tests { assert!(!body.contains("think"), "{body}"); } } + +#[cfg(test)] +mod length_tests { + #![allow(clippy::unwrap_used, clippy::expect_used, clippy::panic)] + use super::*; + + fn p(api: Api, sampling: Sampling<'_>) -> ChatParams<'_> { + ChatParams { + api, + endpoint: "http://x/api/chat", + model: "qwen3.8:27b", + api_key: "", + system_prompt: "", + prompt: "hello", + keep_alive: "", + think: "", + sampling, + } + } + + fn body(api: Api, sampling: Sampling<'_>) -> Result { + let params = p(api, sampling); + let raw = match api { + Api::Ollama => build_ollama_body(¶ms), + Api::Openai | Api::Vllm => build_openai_body(¶ms), + Api::Anthropic => build_anthropic_body(¶ms), + }?; + Ok(serde_json::from_str(&raw).unwrap()) + } + + fn limited(max_tokens: &str) -> Sampling<'_> { + Sampling { + max_tokens, + ..Sampling::default() + } + } + + /// Each wire spells the limit differently; every one must carry it. + #[test] + fn every_wire_carries_the_length_limit() { + assert_eq!( + body(Api::Ollama, limited("400")).unwrap()["options"]["num_predict"], + 400 + ); + assert_eq!( + body(Api::Openai, limited("400")).unwrap()["max_tokens"], + 400 + ); + assert_eq!(body(Api::Vllm, limited("400")).unwrap()["max_tokens"], 400); + assert_eq!( + body(Api::Anthropic, limited("400")).unwrap()["max_tokens"], + 400 + ); + } + + /// Unset leaves the bodies as before: no limit on Ollama and the + /// OpenAI wire, the mandatory default on Anthropic. + #[test] + fn unset_keeps_the_previous_bodies() { + let v = body(Api::Ollama, Sampling::default()).unwrap(); + assert!(v.get("options").is_none(), "{v}"); + let v = body(Api::Vllm, Sampling::default()).unwrap(); + assert!( + v.get("max_tokens").is_none() && v.get("repetition_penalty").is_none(), + "{v}" + ); + assert_eq!( + body(Api::Anthropic, Sampling::default()).unwrap()["max_tokens"], + 4096 + ); + } + + /// Zero would be "no answer" and, for Ollama's -1, "no limit"; + /// a caller writing a limit means neither. + #[test] + fn a_limit_below_one_or_not_a_number_is_refused() { + for raw in ["0", "-1", "12.5", "viel"] { + for api in [Api::Ollama, Api::Openai, Api::Anthropic] { + let err = body(api, limited(raw)).unwrap_err(); + assert!( + err.to_string().contains("max_tokens"), + "{raw} {api:?}: {err}" + ); + } + } + } + + #[test] + fn repeat_penalty_goes_where_the_backend_reads_it() { + let s = Sampling { + repeat_penalty: "1.15", + ..Sampling::default() + }; + assert_eq!( + body(Api::Ollama, s).unwrap()["options"]["repeat_penalty"], + 1.15 + ); + assert_eq!(body(Api::Vllm, s).unwrap()["repetition_penalty"], 1.15); + // No equivalent: refused rather than dropped. + for api in [Api::Openai, Api::Anthropic] { + let err = body(api, s).unwrap_err(); + assert!(err.to_string().contains("repeat_penalty"), "{api:?}: {err}"); + } + } + + /// The case baigle hit: the answer stopped at the limit. The + /// caller must be able to tell that from a finished answer. + #[test] + fn a_cut_off_answer_is_reported_per_wire() { + let cases = [ + ( + Api::Ollama, + r#"{"message":{"content":"§ 566"},"done_reason":"length"}"#, + "length", + true, + ), + ( + Api::Ollama, + r#"{"message":{"content":"ok"},"done_reason":"stop"}"#, + "stop", + false, + ), + ( + Api::Vllm, + r#"{"choices":[{"message":{"content":"x"},"finish_reason":"length"}]}"#, + "length", + true, + ), + ( + Api::Openai, + r#"{"choices":[{"message":{"content":"x"},"finish_reason":"stop"}]}"#, + "stop", + false, + ), + ( + Api::Anthropic, + r#"{"content":[{"text":"x"}],"stop_reason":"max_tokens"}"#, + "max_tokens", + true, + ), + ( + Api::Anthropic, + r#"{"content":[{"text":"x"}],"stop_reason":"end_turn"}"#, + "end_turn", + false, + ), + ]; + for (api, raw, reason, cut) in cases { + let (r, t) = extract_stop(api, raw); + assert_eq!(r.as_deref(), Some(reason), "{api:?}"); + assert_eq!(t, Some(cut), "{api:?}"); + } + } + + /// No reason in the answer is no claim either way. + #[test] + fn no_stop_reason_claims_nothing() { + assert_eq!( + extract_stop(Api::Ollama, r#"{"message":{"content":"x"}}"#), + (None, None) + ); + assert_eq!(extract_stop(Api::Openai, "not json"), (None, None)); + } + + #[test] + fn the_whole_call_reports_the_cut() { + struct One(&'static str); + impl LlmClient for One { + fn post_json( + &self, + url: &str, + _: &str, + _: &[(&'static str, String)], + ) -> Result { + if url.ends_with("/api/show") { + Err(LlmError::Status(404)) + } else { + Ok(self.0.to_string()) + } + } + } + let client = One( + r#"{"message":{"content":"§ 556 BGB § 566 BGB"},"done_reason":"length","eval_count":400}"#, + ); + let out = chat_with_identity(&client, &p(Api::Ollama, limited("400"))).unwrap(); + assert_eq!(out.truncated, Some(true)); + assert_eq!(out.stop_reason.as_deref(), Some("length")); + assert_eq!(out.response, "§ 556 BGB § 566 BGB"); + } +}