Duplicate from StableQuant/Qwen-Templates-Rebuild-Project

Co-authored-by: Mr. Stable Quant <StableQuant@users.noreply.huggingface.co>

.gitattributes

@@ -0,0 +1,35 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

README.md

@@ -0,0 +1,64 @@
+---
+license: apache-2.0
+base_model:
+- Qwen/Qwen3.6-27B
+- Qwen/Qwen3.6-35B-A3B
+- Qwen/Qwen3.5-27B
+- Qwen/Qwen3.5-35B-A3B
+pipeline_tag: text-generation
+library_name: transformers
+tags:
+- chat-template
+- jinja
+- jinja2
+- qwen3
+- template-fix
+- bugfix
+---
+### 23.05 22:00: v1.1.5 is released. Agentic and Tool use works 100% for hours now. Try it out!
+### If you use mainly agentic coding you can also test the "additional-systemprompt" variant out. It adds minimalistic Systempromt Enhancements to 1.1.5 that should work in every environment and actively enhancing correct coding creation and behaviour.
+
+TL:DR Download your fixed and finally working Qwen3.5 and Qwen3.6 jinja chat-template here. V1.1.2 with new tool call error bug fixes and additional edge case enhancements is now released.
+
+You can use this template for any Qwen3 model (only Qwen3-Coder has another template format)
+Compatible with Qwen3, Qwen3.5 and Qwen3.6 in any OpenWeight size yet released!
+
+#### Update: V1.1.5 is out in the wild now!
+Additional fixes to tool calling have been done, verified correct developer role handling and other improvements.
+
+
+#### Preserve Thinking:
+To enable preserve-thinking (Agent can remember what he thought about in older turns) pass the following parameter to llama.cpp startup:
+On Linux&MacOS (Windows need slightly different which cant be correctly displayed here...): --chat-template-kwargs '{"preserve_thinking": true}'
+
+#### OpenCode:
+If using OpenCode do notice they have an open bug for showing thinking content as plain text. Open Bug since 4 months(https://github.com/anomalyco/opencode/issues/11439). Meanwhile you can use the llama.cpp Server switch to hide thinking completely(but still let the model think) using the additonal llama.cpp parameter:
+--reasoning-format deepseek
+
+
+# Welcome to the Template Rebuild Project
+
+How do we got here:
+Annoyed from various bugs with Qwen3.5 and Qwen 3.6 models tool calling etc. I decided to test many different community variants of Qwen Templates, like probably many others out there.
+At the moment there isnt any completly working chat template for the Qwen3.5 and Qwen3.6 models.
+
+Community patches were collected and patched together to made a single final version. But it still contained bugs.
+
+In the spirit and effort of froggeric https://huggingface.co/froggeric/Qwen-Fixed-Chat-Templates/ 
+I want to make this awesome model category useful for any case.
+
+So I did intense preresearch about the models nature, collected a huge list of commonly used ai-tools and which requests do they make to LLM-Endpoints.
+
+All of this was then fed into a new, from the ground up built version of a chat-template.
+
+I believe I did that groundwork, currently I didnt covered all off the over 90 common AI-tools but only like 30, I will continue to enhance the information pile and get 99% tool coverage(100% is probably unnecessary and impossible, considering the fast evolving environment, also many tools use the same calling mechanisms).
+
+This will lead to a final version of the file that is useable for any usecase you can think of.
+
+Currently a third version is released as v1.1.2 which I would call stable
+
+65 specific tests has been run and actual behaviour also manually verified by me.
+
+Please feel free to report any bug you encounter with the template, it will be looked in manually from me and be analyzed and fixed.
+
+Have fun!

qwen3_5-6-template_v1.1.5.jinja

@@ -0,0 +1,314 @@
+{#- ============================================================================
+    Qwen Chat Template v1.1 (Stable Agentic Version + JSON Escaping Fix)
+    
+    FIXES APPLIED IN v1.1:
+    1. Added strict JSON escaping instructions to Section 7 to prevent the LLM
+       from generating raw newlines and quotes inside JSON tool arguments.
+       
+    FIXES APPLIED IN v1.0:
+    1. Kept v0.9 Audio support and strict iterable type checks.
+    2. REMOVED URL text injection before vision/audio pads.
+    3. REMOVED Tool Call ID injection (violates Qwen's native JSON schema).
+    4. RE-APPLIED Context Breakout Prevention (tojson on tool responses).
+    5. RE-APPLIED Think-Mode Tool Call Prevention (Instruction in Section 7).
+============================================================================ -#}
+
+{%- macro raise_exception(message) -%}
+  {{- '\n[ERROR: ' ~ message ~ ']' -}}
+{%- endmacro -%}
+
+{#- ===== SECTION 1A: MACRO render_content ===== -#}
+{%- macro render_content(content, count_vision=false, is_system_content=false) -%}
+  {%- if is_system_content and content is iterable and content is not mapping and content is not string and content is not none -%}
+    {%- for item in content -%}
+      {%- if item.type == 'image' or 'image' in item or 'image_url' in item -%}
+        {{- raise_exception('System message cannot contain images.') -}}
+      {%- endif -%}
+      {%- if item.type == 'video' or 'video' in item -%}
+        {{- raise_exception('System message cannot contain videos.') -}}
+      {%- endif -%}
+    {%- endfor -%}
+  {%- endif -%}
+
+  {%- if content is none or content is defined == false -%}
+    {{- '' -}}
+  {%- elif content is string -%}
+    {{- content -}}
+  {%- elif content is not mapping and content is iterable and content is not string -%}
+    {%- for item in content -%}
+      {%- if item.type == 'image' or 'image' in item or 'image_url' in item -%}
+        {%- if count_vision -%}{%- set ns.image_count = ns.image_count + 1 -%}{%- endif -%}
+        {%- if add_vision_id is defined and add_vision_id -%}
+          {{- 'Picture ' ~ ns.image_count ~ ': ' -}}
+        {%- endif -%}
+        {{- '<|vision_start|><|image_pad|><|vision_end|>' -}}
+      {%- elif item.type == 'audio' or 'audio' in item or 'audio_url' in item -%}
+        {%- if add_vision_id is defined and add_vision_id -%}
+          {{- 'Audio ' ~ ns.image_count ~ ': ' -}}
+        {%- endif -%}
+        {{- '<|audio_pad|><|audio_end|>' -}}
+      {%- elif item.type == 'video' or 'video' in item -%}
+        {%- if count_vision -%}{%- set ns.video_count = ns.video_count + 1 -%}{%- endif -%}
+        {%- if add_vision_id is defined and add_vision_id -%}
+          {{- 'Video ' ~ ns.video_count ~ ': ' -}}
+        {%- endif -%}
+        {{- '<|vision_start|><|video_pad|><|vision_end|>' -}}
+      {%- elif item.type == 'text' or 'text' in item -%}
+        {{- item.text -}}
+      {%- else -%}
+        {{- raise_exception('Unexpected content type in message content.') -}}
+      {%- endif -%}
+    {%- endfor -%}
+  {%- elif content is not none and content is defined -%}
+    {{- raise_exception('Unexpected content type.') -}}
+  {%- endif -%}
+{%- endmacro -%}
+
+{#- ===== SECTION 1B: MACRO detect_tool_error ===== -#}
+{%- macro detect_tool_error(content) -%}
+  {%- set content = content if content is string else '' -%}
+  {%- set content_lower = content | lower -%}
+  {%- set content_length = content | length -%}
+  
+  {%- if content_length < 500
+      and '$ ' not in content
+      and 'took ' not in content_lower
+      and ('"error":' in content_lower or 'error:' in content_lower 
+           or 'exception:' in content_lower or 'traceback' in content_lower 
+           or 'command not found' in content_lower or 'invalid syntax' in content_lower 
+           or 'failed to' in content_lower or 'permission denied' in content_lower) -%}
+    {%- set ns.last_tool_failed = true -%}
+    {%- set ns.consecutive_failures = ns.consecutive_failures + 1 -%}
+  {%- else -%}
+    {%- set ns.last_tool_failed = false -%}
+    {%- set ns.consecutive_failures = 0 -%}
+  {%- endif -%}
+{%- endmacro -%}
+
+{#- ===== SECTION 2: NAMESPACE INITIALISATION ===== -#}
+{%- set ns = namespace(
+    enable_thinking=true,
+    preserve_thinking=true,
+    image_count=0,
+    video_count=0,
+    consecutive_failures=0,
+    last_tool_failed=false
+) -%}
+
+{%- if enable_thinking is defined -%}
+  {%- if enable_thinking -%}
+    {%- set ns.enable_thinking = true -%}
+  {%- else -%}
+    {%- set ns.enable_thinking = false -%}
+  {%- endif -%}
+{%- endif -%}
+
+{%- if preserve_thinking is defined -%}
+  {%- if not preserve_thinking -%}
+    {%- set ns.enable_thinking = false -%}
+    {%- set ns.preserve_thinking = false -%}
+  {%- else -%}
+    {%- set ns.preserve_thinking = true -%}
+  {%- endif -%}
+{%- endif -%}
+
+{#- ===== SECTION 3: PRE-SCAN ===== -#}
+{%- for i in range(messages | length) -%}
+  {%- set _msg = messages[i] -%}
+  {%- if _msg.role == 'user' -%}
+    {%- set _u = _msg.content if _msg.content is string else '' -%}
+    {%- if _u.rstrip().endswith('/no_think') -%}
+      {%- set ns.enable_thinking = false -%}
+    {%- elif _u.rstrip().endswith('/think') -%}
+      {%- set ns.enable_thinking = true -%}
+    {%- endif -%}
+  {%- elif _msg.role == 'system' or _msg.role == 'developer' -%}
+    {%- set _s = _msg.content if _msg.content is string else '' -%}
+    {%- if '<|think_off|>' in _s -%}
+      {%- set ns.enable_thinking = false -%}
+    {%- elif '<|think_on|>' in _s -%}
+      {%- set ns.enable_thinking = true -%}
+    {%- endif -%}
+  {%- endif -%}
+{%- endfor -%}
+
+{#- ===== SECTION 4: VALIDATE MESSAGES ===== -#}
+{%- if not messages -%}
+  {{- raise_exception('No messages provided.') -}}
+{%- endif -%}
+
+{#- ===== SECTION 5: COLLECT SYSTEM CONTENT ===== -#}
+{%- set ns_sys = namespace(content='') -%}
+{%- for msg in messages -%}
+  {%- if msg.role == 'system' or msg.role == 'developer' -%}
+    {%- set _c = render_content(msg.content | default(''), false, true) | trim -%}
+    {%- set _c = _c | replace('<|think_off|>', '') | replace('<|think_on|>', '') | trim -%}
+    {%- if _c -%}
+      {%- if ns_sys.content == '' -%}
+        {%- set ns_sys.content = _c -%}
+      {%- else -%}
+        {%- set ns_sys.content = ns_sys.content + '\n\n' + _c -%}
+      {%- endif -%}
+    {%- endif -%}
+  {%- endif -%}
+{%- endfor -%}
+
+{#- ===== SECTION 6: BUILD TOOLS LIST ===== -#}
+{%- set _has_tools = tools is defined and tools -%}
+{%- if _has_tools -%}
+  {%- set ns_tb = namespace(list=[]) -%}
+  {%- for tool in tools -%}
+    {%- if tool.function is defined -%}
+      {%- set ns_tb.list = ns_tb.list + [tool] -%}
+    {%- else -%}
+      {%- set ns_tb.list = ns_tb.list + [{"type": "function", "function": tool}] -%}
+    {%- endif -%}
+  {%- endfor -%}
+{%- endif -%}
+
+{#- ===== SECTION 7: OUTPUT SYSTEM TURN ===== -#}
+{%- if ns_sys.content or _has_tools -%}
+  {{- '<|im_start|>system\n' -}}
+  {%- if ns_sys.content -%}
+    {{- ns_sys.content -}}
+    {%- if _has_tools -%}{{- '\n\n' -}}{%- endif -%}
+  {%- endif -%}
+  {%- if _has_tools -%}
+    {{- '# Tools\n\nYou may call one or more functions to assist with the user query.\n\nYou are provided with function signatures within <tools></tools> XML tags:\n<tools>\n' -}}
+    {%- for tool in ns_tb.list -%}
+      {{- tool | tojson -}}
+      {%- if not loop.last -%}{{- '\n' -}}{%- endif -%}
+    {%- endfor -%}
+    {#- FIX v1.1: Added JSON strict escaping warnings to critical instructions -#}
+    {{- '\n</tools>\n\nFor each function call, return a json object with function name and arguments within <tool_call></tool_call> XML tags:\n<tool_call>\n{"name": <function-name>, "arguments": <args-json-object>}\n</tool_call>\n\nCRITICAL INSTRUCTIONS:\n1. You MUST NOT output <tool_call> tags while inside <think> tags. Complete your reasoning and output </think> FIRST, then initiate your tool calls.\n2. When passing multi-line code or text containing quotes into a JSON argument, you MUST strictly escape all newlines as \\n and quotes as \\". Failure to escape will invalidate the JSON and crash the system.' -}}
+  {%- endif -%}
+  {{- '<|im_end|>\n' -}}
+{%- endif -%}
+
+{#- ===== SECTION 8: MAIN MESSAGE LOOP ===== -#}
+{%- for message in messages -%}
+
+  {%- if message.role == 'system' or message.role == 'developer' -%}
+
+  {%- elif message.role == 'user' -%}
+    {%- set _uc = render_content(message.content | default(''), true, false) -%}
+    {{- '<|im_start|>user\n' + _uc + '<|im_end|>\n' -}}
+
+  {%- elif message.role == 'assistant' -%}
+    {%- if message.content is defined and message.content is string -%}
+      {%- set _ac = message.content -%}
+    {%- elif message.content is defined and message.content is iterable and message.content is not mapping and message.content is not string -%}
+      {%- set _ac = render_content(message.content, false, false) -%}
+    {%- else -%}
+      {%- set _ac = '' -%}
+    {%- endif -%}
+
+    {%- if message.reasoning_content is defined and message.reasoning_content is string
+        and message.reasoning_content | trim
+        and '<think>' not in _ac -%}
+      {%- set _ac = '<think>\n' + message.reasoning_content | trim + '\n</think>\n\n' + _ac -%}
+    {%- endif -%}
+
+    {%- set _tc = message.tool_calls if message.tool_calls is defined and message.tool_calls is iterable and message.tool_calls is not string else [] -%}
+
+    {%- if _tc and '<tool_call>' in _ac -%}
+      {%- set _ac = _ac.split('<tool_call>')[0] | trim -%}
+    {%- endif -%}
+
+    {%- set _show_think = false -%}
+    {%- if _tc -%}
+      {%- set _show_think = true -%}
+    {%- elif ns.preserve_thinking -%}
+      {%- set _show_think = true -%}
+    {%- elif loop.last -%}
+      {%- set _show_think = ns.enable_thinking -%}
+    {%- endif -%}
+
+    {%- if not _show_think -%}
+      {%- set _think_end = '' -%}
+      {%- if '</think>' in _ac -%}
+        {%- set _think_end = '</think>' -%}
+      {%- elif '</thinking>' in _ac -%}
+        {%- set _think_end = '</thinking>' -%}
+      {%- elif '</ think>' in _ac -%}
+        {%- set _think_end = '</ think>' -%}
+      {%- elif '</think >' in _ac -%}
+        {%- set _think_end = '</think >' -%}
+      {%- endif -%}
+      {%- if _think_end -%}
+        {%- set _ac = _ac.split(_think_end)[-1].lstrip('\n') -%}
+      {%- endif -%}
+    {%- elif not _tc and loop.last and '<think>' not in _ac and not ns.enable_thinking -%}
+      {%- set _ac = '<think>\n\n</think>\n\n' + _ac -%}
+    {%- endif -%}
+
+    {{- '<|im_start|>assistant\n' -}}
+    {%- if _ac -%}
+      {{- _ac -}}
+      {%- if _tc -%}{{- '\n' -}}{%- endif -%}
+    {%- endif -%}
+
+    {%- if _tc -%}
+      {%- for tc in _tc -%}
+        {{- '<tool_call>\n' -}}
+        {{- '{"name": ' -}}{{- tc.function.name | tojson -}}
+        {%- if tc.function.arguments is string -%}
+          {{- ', "arguments": ' + tc.function.arguments -}}
+        {%- else -%}
+          {{- ', "arguments": ' -}}{{- tc.function.arguments | tojson -}}
+        {%- endif -%}
+        {{- '}' -}}
+        {%- if not loop.last -%}
+          {{- '\n</tool_call>\n' -}}
+        {%- else -%}
+          {{- '\n</tool_call>' -}}
+        {%- endif -%}
+      {%- endfor -%}
+    {%- endif -%}
+    {{- '<|im_end|>\n' -}}
+
+  {#- 8d: Tool results -#}
+  {%- elif message.role == 'tool' -%}
+    {%- set _prev_role = messages[loop.index0 - 1].role if loop.index0 > 0 else '' -%}
+    {%- set _next_role = messages[loop.index0 + 1].role if not loop.last else '' -%}
+    
+    {%- set _tool_content = message.content | default('') -%}
+    {{- detect_tool_error(_tool_content) -}}
+
+    {%- if _prev_role != 'tool' -%}
+      {{- '<|im_start|>user\n' -}}
+    {%- endif -%}
+    {{- '<tool_response>\n' -}}
+    
+    {{- '{"result": ' ~ _tool_content | string | tojson ~ '}' -}}
+    
+    {%- if ns.last_tool_failed -%}
+      {%- if ns.consecutive_failures >= 2 -%}
+        {{- '\n\n[SYSTEM WARNING: ' ~ ns.consecutive_failures ~ ' consecutive tool errors detected. Your previous approach is incorrect.]' -}}
+      {%- else -%}
+        {{- '\n\n[SYSTEM WARNING: The previous tool call returned an error. Diagnose the failure and retry with corrected arguments.]' -}}
+      {%- endif -%}
+    {%- endif -%}
+
+    {%- if _next_role == 'tool' -%}
+      {{- '\n</tool_response>\n' -}}
+    {%- else -%}
+      {{- '\n</tool_response>' -}}
+      {{- '<|im_end|>\n' -}}
+    {%- endif -%}
+
+  {%- else -%}
+    {{- raise_exception('Unexpected message role: ' + message.role) -}}
+  {%- endif -%}
+
+{%- endfor -%}
+
+{#- ===== SECTION 9: GENERATION PROMPT ===== -#}
+{%- if add_generation_prompt -%}
+  {{- '<|im_start|>assistant\n' -}}
+  {%- if ns.enable_thinking -%}
+    {{- '<think>\n' -}}
+  {%- else -%}
+    {{- '<think>\n\n</think>\n\n' -}}
+  {%- endif -%}
+{%- endif -%}

v1.1.5-variant1_added_agentic-coding-prompt-enhancements.jinja

@@ -0,0 +1,319 @@
+{#- ============================================================================
+    Qwen Chat Template v1.2 (Ultimate Agentic Version)
+    
+    FIXES APPLIED IN v1.2:
+    1. Added comprehensive Agentic rules to Section 7 (NO LAZINESS, BREAK LOOPS,
+       STRICT TOOLS, VERIFY) to prevent common agentic loops and lazy coding
+       behaviors in frameworks like Hermes and OpenHands.
+       
+    FIXES APPLIED IN v1.1:
+    1. Added strict JSON escaping instructions to prevent Context Breakouts during
+       outbound code generation.
+       
+    FIXES APPLIED IN v1.0:
+    1. Kept v0.9 Audio support and strict iterable type checks.
+    2. REMOVED URL text injection before vision/audio pads.
+    3. REMOVED Tool Call ID injection (violates Qwen's native JSON schema).
+    4. RE-APPLIED Context Breakout Prevention (tojson on tool responses).
+    5. RE-APPLIED Think-Mode Tool Call Prevention (Instruction in Section 7).
+============================================================================ -#}
+
+{%- macro raise_exception(message) -%}
+  {{- '\n[ERROR: ' ~ message ~ ']' -}}
+{%- endmacro -%}
+
+{#- ===== SECTION 1A: MACRO render_content ===== -#}
+{%- macro render_content(content, count_vision=false, is_system_content=false) -%}
+  {%- if is_system_content and content is iterable and content is not mapping and content is not string and content is not none -%}
+    {%- for item in content -%}
+      {%- if item.type == 'image' or 'image' in item or 'image_url' in item -%}
+        {{- raise_exception('System message cannot contain images.') -}}
+      {%- endif -%}
+      {%- if item.type == 'video' or 'video' in item -%}
+        {{- raise_exception('System message cannot contain videos.') -}}
+      {%- endif -%}
+    {%- endfor -%}
+  {%- endif -%}
+
+  {%- if content is none or content is defined == false -%}
+    {{- '' -}}
+  {%- elif content is string -%}
+    {{- content -}}
+  {%- elif content is not mapping and content is iterable and content is not string -%}
+    {%- for item in content -%}
+      {%- if item.type == 'image' or 'image' in item or 'image_url' in item -%}
+        {%- if count_vision -%}{%- set ns.image_count = ns.image_count + 1 -%}{%- endif -%}
+        {%- if add_vision_id is defined and add_vision_id -%}
+          {{- 'Picture ' ~ ns.image_count ~ ': ' -}}
+        {%- endif -%}
+        {{- '<|vision_start|><|image_pad|><|vision_end|>' -}}
+      {%- elif item.type == 'audio' or 'audio' in item or 'audio_url' in item -%}
+        {%- if add_vision_id is defined and add_vision_id -%}
+          {{- 'Audio ' ~ ns.image_count ~ ': ' -}}
+        {%- endif -%}
+        {{- '<|audio_pad|><|audio_end|>' -}}
+      {%- elif item.type == 'video' or 'video' in item -%}
+        {%- if count_vision -%}{%- set ns.video_count = ns.video_count + 1 -%}{%- endif -%}
+        {%- if add_vision_id is defined and add_vision_id -%}
+          {{- 'Video ' ~ ns.video_count ~ ': ' -}}
+        {%- endif -%}
+        {{- '<|vision_start|><|video_pad|><|vision_end|>' -}}
+      {%- elif item.type == 'text' or 'text' in item -%}
+        {{- item.text -}}
+      {%- else -%}
+        {{- raise_exception('Unexpected content type in message content.') -}}
+      {%- endif -%}
+    {%- endfor -%}
+  {%- elif content is not none and content is defined -%}
+    {{- raise_exception('Unexpected content type.') -}}
+  {%- endif -%}
+{%- endmacro -%}
+
+{#- ===== SECTION 1B: MACRO detect_tool_error ===== -#}
+{%- macro detect_tool_error(content) -%}
+  {%- set content = content if content is string else '' -%}
+  {%- set content_lower = content | lower -%}
+  {%- set content_length = content | length -%}
+  
+  {%- if content_length < 500
+      and '$ ' not in content
+      and 'took ' not in content_lower
+      and ('"error":' in content_lower or 'error:' in content_lower 
+           or 'exception:' in content_lower or 'traceback' in content_lower 
+           or 'command not found' in content_lower or 'invalid syntax' in content_lower 
+           or 'failed to' in content_lower or 'permission denied' in content_lower) -%}
+    {%- set ns.last_tool_failed = true -%}
+    {%- set ns.consecutive_failures = ns.consecutive_failures + 1 -%}
+  {%- else -%}
+    {%- set ns.last_tool_failed = false -%}
+    {%- set ns.consecutive_failures = 0 -%}
+  {%- endif -%}
+{%- endmacro -%}
+
+{#- ===== SECTION 2: NAMESPACE INITIALISATION ===== -#}
+{%- set ns = namespace(
+    enable_thinking=true,
+    preserve_thinking=true,
+    image_count=0,
+    video_count=0,
+    consecutive_failures=0,
+    last_tool_failed=false
+) -%}
+
+{%- if enable_thinking is defined -%}
+  {%- if enable_thinking -%}
+    {%- set ns.enable_thinking = true -%}
+  {%- else -%}
+    {%- set ns.enable_thinking = false -%}
+  {%- endif -%}
+{%- endif -%}
+
+{%- if preserve_thinking is defined -%}
+  {%- if not preserve_thinking -%}
+    {%- set ns.enable_thinking = false -%}
+    {%- set ns.preserve_thinking = false -%}
+  {%- else -%}
+    {%- set ns.preserve_thinking = true -%}
+  {%- endif -%}
+{%- endif -%}
+
+{#- ===== SECTION 3: PRE-SCAN ===== -#}
+{%- for i in range(messages | length) -%}
+  {%- set _msg = messages[i] -%}
+  {%- if _msg.role == 'user' -%}
+    {%- set _u = _msg.content if _msg.content is string else '' -%}
+    {%- if _u.rstrip().endswith('/no_think') -%}
+      {%- set ns.enable_thinking = false -%}
+    {%- elif _u.rstrip().endswith('/think') -%}
+      {%- set ns.enable_thinking = true -%}
+    {%- endif -%}
+  {%- elif _msg.role == 'system' or _msg.role == 'developer' -%}
+    {%- set _s = _msg.content if _msg.content is string else '' -%}
+    {%- if '<|think_off|>' in _s -%}
+      {%- set ns.enable_thinking = false -%}
+    {%- elif '<|think_on|>' in _s -%}
+      {%- set ns.enable_thinking = true -%}
+    {%- endif -%}
+  {%- endif -%}
+{%- endfor -%}
+
+{#- ===== SECTION 4: VALIDATE MESSAGES ===== -#}
+{%- if not messages -%}
+  {{- raise_exception('No messages provided.') -}}
+{%- endif -%}
+
+{#- ===== SECTION 5: COLLECT SYSTEM CONTENT ===== -#}
+{%- set ns_sys = namespace(content='') -%}
+{%- for msg in messages -%}
+  {%- if msg.role == 'system' or msg.role == 'developer' -%}
+    {%- set _c = render_content(msg.content | default(''), false, true) | trim -%}
+    {%- set _c = _c | replace('<|think_off|>', '') | replace('<|think_on|>', '') | trim -%}
+    {%- if _c -%}
+      {%- if ns_sys.content == '' -%}
+        {%- set ns_sys.content = _c -%}
+      {%- else -%}
+        {%- set ns_sys.content = ns_sys.content + '\n\n' + _c -%}
+      {%- endif -%}
+    {%- endif -%}
+  {%- endif -%}
+{%- endfor -%}
+
+{#- ===== SECTION 6: BUILD TOOLS LIST ===== -#}
+{%- set _has_tools = tools is defined and tools -%}
+{%- if _has_tools -%}
+  {%- set ns_tb = namespace(list=[]) -%}
+  {%- for tool in tools -%}
+    {%- if tool.function is defined -%}
+      {%- set ns_tb.list = ns_tb.list + [tool] -%}
+    {%- else -%}
+      {%- set ns_tb.list = ns_tb.list + [{"type": "function", "function": tool}] -%}
+    {%- endif -%}
+  {%- endfor -%}
+{%- endif -%}
+
+{#- ===== SECTION 7: OUTPUT SYSTEM TURN ===== -#}
+{%- if ns_sys.content or _has_tools -%}
+  {{- '<|im_start|>system\n' -}}
+  {%- if ns_sys.content -%}
+    {{- ns_sys.content -}}
+    {%- if _has_tools -%}{{- '\n\n' -}}{%- endif -%}
+  {%- endif -%}
+  {%- if _has_tools -%}
+    {{- '# Tools\n\nYou may call one or more functions to assist with the user query.\n\nYou are provided with function signatures within <tools></tools> XML tags:\n<tools>\n' -}}
+    {%- for tool in ns_tb.list -%}
+      {{- tool | tojson -}}
+      {%- if not loop.last -%}{{- '\n' -}}{%- endif -%}
+    {%- endfor -%}
+    {#- FIX v1.2: Added comprehensive agentic rules to the critical instructions -#}
+    {{- '\n</tools>\n\nFor each function call, return a json object with function name and arguments within <tool_call></tool_call> XML tags:\n<tool_call>\n{"name": <function-name>, "arguments": <args-json-object>}\n</tool_call>\n\nCRITICAL INSTRUCTIONS:\n1. You MUST NOT output <tool_call> tags while inside <think> tags. Complete your reasoning and output </think> FIRST, then initiate your tool calls.\n2. When passing multi-line code or text containing quotes into a JSON argument, you MUST strictly escape all newlines as \\n and quotes as \\". Failure to escape will invalidate the JSON and crash the system.\n3. NO LAZINESS: Never use placeholders like "// existing code" or "/* rest of function */". You must output the complete, runnable code block required by the tool.\n4. BREAK LOOPS: If a tool call fails with an error, DO NOT repeat the exact same call. Analyze the error, change your approach, use alternative tools, or ask the user for clarification.\n5. STRICT TOOLS: Only use the exact function names listed in the <tools> block. Do not invent new tools or use colon-separated namespaces unless explicitly provided.\n6. VERIFY: After making file changes, always run tests or use terminal commands to verify your code compiles and works before responding to the user.' -}}
+  {%- endif -%}
+  {{- '<|im_end|>\n' -}}
+{%- endif -%}
+
+{#- ===== SECTION 8: MAIN MESSAGE LOOP ===== -#}
+{%- for message in messages -%}
+
+  {%- if message.role == 'system' or message.role == 'developer' -%}
+
+  {%- elif message.role == 'user' -%}
+    {%- set _uc = render_content(message.content | default(''), true, false) -%}
+    {{- '<|im_start|>user\n' + _uc + '<|im_end|>\n' -}}
+
+  {%- elif message.role == 'assistant' -%}
+    {%- if message.content is defined and message.content is string -%}
+      {%- set _ac = message.content -%}
+    {%- elif message.content is defined and message.content is iterable and message.content is not mapping and message.content is not string -%}
+      {%- set _ac = render_content(message.content, false, false) -%}
+    {%- else -%}
+      {%- set _ac = '' -%}
+    {%- endif -%}
+
+    {%- if message.reasoning_content is defined and message.reasoning_content is string
+        and message.reasoning_content | trim
+        and '<think>' not in _ac -%}
+      {%- set _ac = '<think>\n' + message.reasoning_content | trim + '\n</think>\n\n' + _ac -%}
+    {%- endif -%}
+
+    {%- set _tc = message.tool_calls if message.tool_calls is defined and message.tool_calls is iterable and message.tool_calls is not string else [] -%}
+
+    {%- if _tc and '<tool_call>' in _ac -%}
+      {%- set _ac = _ac.split('<tool_call>')[0] | trim -%}
+    {%- endif -%}
+
+    {%- set _show_think = false -%}
+    {%- if _tc -%}
+      {%- set _show_think = true -%}
+    {%- elif ns.preserve_thinking -%}
+      {%- set _show_think = true -%}
+    {%- elif loop.last -%}
+      {%- set _show_think = ns.enable_thinking -%}
+    {%- endif -%}
+
+    {%- if not _show_think -%}
+      {%- set _think_end = '' -%}
+      {%- if '</think>' in _ac -%}
+        {%- set _think_end = '</think>' -%}
+      {%- elif '</thinking>' in _ac -%}
+        {%- set _think_end = '</thinking>' -%}
+      {%- elif '</ think>' in _ac -%}
+        {%- set _think_end = '</ think>' -%}
+      {%- elif '</think >' in _ac -%}
+        {%- set _think_end = '</think >' -%}
+      {%- endif -%}
+      {%- if _think_end -%}
+        {%- set _ac = _ac.split(_think_end)[-1].lstrip('\n') -%}
+      {%- endif -%}
+    {%- elif not _tc and loop.last and '<think>' not in _ac and not ns.enable_thinking -%}
+      {%- set _ac = '<think>\n\n</think>\n\n' + _ac -%}
+    {%- endif -%}
+
+    {{- '<|im_start|>assistant\n' -}}
+    {%- if _ac -%}
+      {{- _ac -}}
+      {%- if _tc -%}{{- '\n' -}}{%- endif -%}
+    {%- endif -%}
+
+    {%- if _tc -%}
+      {%- for tc in _tc -%}
+        {{- '<tool_call>\n' -}}
+        {{- '{"name": ' -}}{{- tc.function.name | tojson -}}
+        {%- if tc.function.arguments is string -%}
+          {{- ', "arguments": ' + tc.function.arguments -}}
+        {%- else -%}
+          {{- ', "arguments": ' -}}{{- tc.function.arguments | tojson -}}
+        {%- endif -%}
+        {{- '}' -}}
+        {%- if not loop.last -%}
+          {{- '\n</tool_call>\n' -}}
+        {%- else -%}
+          {{- '\n</tool_call>' -}}
+        {%- endif -%}
+      {%- endfor -%}
+    {%- endif -%}
+    {{- '<|im_end|>\n' -}}
+
+  {#- 8d: Tool results -#}
+  {%- elif message.role == 'tool' -%}
+    {%- set _prev_role = messages[loop.index0 - 1].role if loop.index0 > 0 else '' -%}
+    {%- set _next_role = messages[loop.index0 + 1].role if not loop.last else '' -%}
+    
+    {%- set _tool_content = message.content | default('') -%}
+    {{- detect_tool_error(_tool_content) -}}
+
+    {%- if _prev_role != 'tool' -%}
+      {{- '<|im_start|>user\n' -}}
+    {%- endif -%}
+    {{- '<tool_response>\n' -}}
+    
+    {{- '{"result": ' ~ _tool_content | string | tojson ~ '}' -}}
+    
+    {%- if ns.last_tool_failed -%}
+      {%- if ns.consecutive_failures >= 2 -%}
+        {{- '\n\n[SYSTEM WARNING: ' ~ ns.consecutive_failures ~ ' consecutive tool errors detected. Your previous approach is incorrect.]' -}}
+      {%- else -%}
+        {{- '\n\n[SYSTEM WARNING: The previous tool call returned an error. Diagnose the failure and retry with corrected arguments.]' -}}
+      {%- endif -%}
+    {%- endif -%}
+
+    {%- if _next_role == 'tool' -%}
+      {{- '\n</tool_response>\n' -}}
+    {%- else -%}
+      {{- '\n</tool_response>' -}}
+      {{- '<|im_end|>\n' -}}
+    {%- endif -%}
+
+  {%- else -%}
+    {{- raise_exception('Unexpected message role: ' + message.role) -}}
+  {%- endif -%}
+
+{%- endfor -%}
+
+{#- ===== SECTION 9: GENERATION PROMPT ===== -#}
+{%- if add_generation_prompt -%}
+  {{- '<|im_start|>assistant\n' -}}
+  {%- if ns.enable_thinking -%}
+    {{- '<think>\n' -}}
+  {%- else -%}
+    {{- '<think>\n\n</think>\n\n' -}}
+  {%- endif -%}
+{%- endif -%}