1pub const STREAMING_VIRTUAL_FIELDS: &[&str] = &[
34 "chunks",
35 "chunks.length",
36 "stream_content",
37 "stream_complete",
38 "no_chunks_after_done",
39 "tool_calls",
40 "finish_reason",
41];
42
43const STREAMING_VIRTUAL_ROOTS: &[&str] = &["tool_calls", "finish_reason"];
53
54pub fn is_streaming_virtual_field(field: &str) -> bool {
62 if STREAMING_VIRTUAL_FIELDS.contains(&field) {
63 return true;
64 }
65 for root in STREAMING_VIRTUAL_ROOTS {
67 if field.len() > root.len() && field.starts_with(root) {
68 let rest = &field[root.len()..];
69 if rest.starts_with('[') || rest.starts_with('.') {
70 return true;
71 }
72 }
73 }
74 false
75}
76
77fn split_streaming_deep_path(field: &str) -> Option<(&str, &str)> {
83 for root in STREAMING_VIRTUAL_ROOTS {
84 if field.len() > root.len() && field.starts_with(root) {
85 let rest = &field[root.len()..];
86 if rest.starts_with('[') || rest.starts_with('.') {
87 return Some((root, rest));
88 }
89 }
90 }
91 None
92}
93
94const STREAMING_ONLY_AUTO_DETECT_FIELDS: &[&str] = &[
101 "chunks",
102 "chunks.length",
103 "stream_content",
104 "stream_complete",
105 "no_chunks_after_done",
106];
107
108pub fn resolve_is_streaming(fixture: &crate::fixture::Fixture, call_streaming: Option<bool>) -> bool {
120 if let Some(forced) = call_streaming {
121 return forced;
122 }
123 fixture.is_streaming_mock()
124 || fixture.assertions.iter().any(|a| {
125 a.field
126 .as_deref()
127 .is_some_and(|f| !f.is_empty() && STREAMING_ONLY_AUTO_DETECT_FIELDS.contains(&f))
128 })
129}
130
131pub struct StreamingFieldResolver;
133
134impl StreamingFieldResolver {
135 pub fn accessor(field: &str, lang: &str, chunks_var: &str) -> Option<String> {
141 match field {
142 "chunks" => Some(match lang {
143 "zig" => format!("{chunks_var}.items"),
145 "php" => format!("${chunks_var}"),
148 _ => chunks_var.to_string(),
149 }),
150
151 "chunks.length" => Some(match lang {
152 "rust" => format!("{chunks_var}.len()"),
153 "go" => format!("len({chunks_var})"),
154 "python" => format!("len({chunks_var})"),
155 "php" => format!("count(${chunks_var})"),
156 "elixir" => format!("length({chunks_var})"),
157 "kotlin" => format!("{chunks_var}.size"),
159 "zig" => format!("{chunks_var}.items.len"),
161 _ => format!("{chunks_var}.length"),
163 }),
164
165 "stream_content" => Some(match lang {
166 "rust" => {
167 format!(
168 "{chunks_var}.iter().map(|c| c.choices.first().and_then(|ch| ch.delta.content.as_deref()).unwrap_or(\"\")).collect::<String>()"
169 )
170 }
171 "go" => {
172 format!(
174 "func() string {{ var s string; for _, c := range {chunks_var} {{ if len(c.Choices) > 0 && c.Choices[0].Delta.Content != nil {{ s += *c.Choices[0].Delta.Content }} }}; return s }}()"
175 )
176 }
177 "java" => {
178 format!(
179 "{chunks_var}.stream().map(c -> c.choices().stream().findFirst().map(ch -> ch.delta().content() != null ? ch.delta().content() : \"\").orElse(\"\")).collect(java.util.stream.Collectors.joining())"
180 )
181 }
182 "php" => {
183 format!("implode('', array_map(fn($c) => $c->choices[0]->delta->content ?? '', ${chunks_var}))")
184 }
185 "kotlin" => {
186 format!(
189 "{chunks_var}.joinToString(\"\") {{ it.choices()?.firstOrNull()?.delta()?.content() ?: \"\" }}"
190 )
191 }
192 "elixir" => {
193 format!(
197 "{chunks_var} |> Enum.map(fn c -> (Enum.at(c.choices, 0) || %{{}}) |> Map.get(:delta, %{{}}) |> Map.get(:content, \"\") end) |> Enum.join(\"\")"
198 )
199 }
200 "python" => {
201 format!("\"\".join(c.choices[0].delta.content or \"\" for c in {chunks_var} if c.choices)")
202 }
203 "zig" => {
204 format!("{chunks_var}_content.items")
207 }
208 _ => {
210 format!("{chunks_var}.map((c: any) => c.choices?.[0]?.delta?.content ?? '').join('')")
211 }
212 }),
213
214 "stream_complete" => Some(match lang {
215 "rust" => {
216 format!(
217 "{chunks_var}.last().and_then(|c| c.choices.first()).and_then(|ch| ch.finish_reason.as_ref()).is_some()"
218 )
219 }
220 "go" => {
221 format!(
222 "func() bool {{ if len({chunks_var}) == 0 {{ return false }}; last := {chunks_var}[len({chunks_var})-1]; return len(last.Choices) > 0 && last.Choices[0].FinishReason != nil }}()"
223 )
224 }
225 "java" => {
226 format!(
227 "!{chunks_var}.isEmpty() && {chunks_var}.get({chunks_var}.size()-1).choices().stream().findFirst().flatMap(ch -> java.util.Optional.ofNullable(ch.finishReason())).isPresent()"
228 )
229 }
230 "php" => {
231 format!("!empty(${chunks_var}) && isset(end(${chunks_var})->choices[0]->finishReason)")
235 }
236 "kotlin" => {
237 format!(
239 "{chunks_var}.isNotEmpty() && {chunks_var}.last().choices()?.firstOrNull()?.finishReason() != null"
240 )
241 }
242 "python" => {
243 format!("bool({chunks_var}) and {chunks_var}[-1].choices[0].finish_reason is not None")
244 }
245 "elixir" => {
246 format!("Enum.at(List.last({chunks_var}).choices, 0).finish_reason != nil")
247 }
248 "zig" => {
251 format!("{chunks_var}.items.len > 0")
252 }
253 _ => {
255 format!(
256 "{chunks_var}.length > 0 && {chunks_var}[{chunks_var}.length - 1].choices?.[0]?.finishReason != null"
257 )
258 }
259 }),
260
261 "no_chunks_after_done" => Some(match lang {
265 "rust" => "true".to_string(),
266 "go" => "true".to_string(),
267 "java" => "true".to_string(),
268 "php" => "true".to_string(),
269 _ => "true".to_string(),
270 }),
271
272 "tool_calls" => Some(match lang {
273 "rust" => {
274 format!(
275 "{chunks_var}.iter().flat_map(|c| c.choices.iter().flat_map(|ch| ch.delta.tool_calls.iter().flatten())).collect::<Vec<_>>()"
276 )
277 }
278 "go" => {
279 format!(
283 "func() []pkg.StreamToolCall {{ var tc []pkg.StreamToolCall; for _, c := range {chunks_var} {{ for _, ch := range c.Choices {{ tc = append(tc, ch.Delta.ToolCalls...) }} }}; return tc }}()"
284 )
285 }
286 "java" => {
287 format!(
288 "{chunks_var}.stream().flatMap(c -> c.choices().stream()).flatMap(ch -> ch.delta().toolCalls() != null ? ch.delta().toolCalls().stream() : java.util.stream.Stream.empty()).toList()"
289 )
290 }
291 "php" => {
292 format!(
295 "array_merge(...array_map(fn($c) => $c->choices[0]->delta->toolCalls ?? [], ${chunks_var}))"
296 )
297 }
298 "kotlin" => {
299 format!(
301 "{chunks_var}.flatMap {{ c -> c.choices()?.flatMap {{ ch -> ch.delta()?.toolCalls() ?: emptyList() }} ?: emptyList() }}"
302 )
303 }
304 "python" => {
305 format!(
306 "[t for c in {chunks_var} for ch in (c.choices or []) for t in (ch.delta.tool_calls or [])]"
307 )
308 }
309 "elixir" => {
310 format!(
311 "{chunks_var} |> Enum.flat_map(fn c -> (List.first(c.choices) || %{{}}).delta |> Map.get(:tool_calls, []) end)"
312 )
313 }
314 "zig" => {
316 format!("{chunks_var}.items")
317 }
318 _ => {
319 format!("{chunks_var}.flatMap((c: any) => c.choices?.[0]?.delta?.toolCalls ?? [])")
320 }
321 }),
322
323 "finish_reason" => Some(match lang {
324 "rust" => {
325 format!(
328 "{chunks_var}.last().and_then(|c| c.choices.first()).and_then(|ch| ch.finish_reason.as_ref()).map(|v| v.to_string()).unwrap_or_default()"
329 )
330 }
331 "go" => {
332 format!(
335 "func() string {{ if len({chunks_var}) == 0 {{ return \"\" }}; last := {chunks_var}[len({chunks_var})-1]; if len(last.Choices) > 0 && last.Choices[0].FinishReason != nil {{ return string(*last.Choices[0].FinishReason) }}; return \"\" }}()"
336 )
337 }
338 "java" => {
339 format!(
343 "({chunks_var}.isEmpty() ? null : {chunks_var}.get({chunks_var}.size()-1).choices().stream().findFirst().map(ch -> ch.finishReason() == null ? null : ch.finishReason().getValue()).orElse(null))"
344 )
345 }
346 "php" => {
347 format!("(!empty(${chunks_var}) ? (end(${chunks_var})->choices[0]->finishReason ?? null) : null)")
350 }
351 "kotlin" => {
352 format!(
355 "(if ({chunks_var}.isEmpty()) null else {chunks_var}.last().choices()?.firstOrNull()?.finishReason()?.getValue())"
356 )
357 }
358 "python" => {
359 format!(
363 "(str({chunks_var}[-1].choices[0].finish_reason) if {chunks_var} and {chunks_var}[-1].choices else None)"
364 )
365 }
366 "elixir" => {
367 format!("Enum.at(List.last({chunks_var}).choices, 0).finish_reason")
368 }
369 "zig" => {
372 format!(
373 "(blk: {{ if ({chunks_var}.items.len == 0) break :blk \"\"; var _lcp = std.json.parseFromSlice(std.json.Value, std.heap.c_allocator, {chunks_var}.items[{chunks_var}.items.len - 1], .{{}}) catch break :blk \"\"; defer _lcp.deinit(); if (_lcp.value.object.get(\"choices\")) |_lchs| if (_lchs.array.items.len > 0) if (_lchs.array.items[0].object.get(\"finish_reason\")) |_fr| if (_fr == .string) break :blk _fr.string; break :blk \"\"; }})"
374 )
375 }
376 _ => {
377 format!(
378 "{chunks_var}.length > 0 ? {chunks_var}[{chunks_var}.length - 1].choices?.[0]?.finishReason : undefined"
379 )
380 }
381 }),
382
383 "usage" => Some(match lang {
388 "python" => {
389 format!("({chunks_var}[-1].usage if {chunks_var} else None)")
393 }
394 "rust" => {
395 format!("{chunks_var}.last().and_then(|c| c.usage.as_ref())")
396 }
397 "go" => {
398 format!(
399 "func() interface{{}} {{ if len({chunks_var}) == 0 {{ return nil }}; return {chunks_var}[len({chunks_var})-1].Usage }}()"
400 )
401 }
402 "java" => {
403 format!("({chunks_var}.isEmpty() ? null : {chunks_var}.get({chunks_var}.size()-1).usage())")
404 }
405 "kotlin" => {
406 format!("(if ({chunks_var}.isEmpty()) null else {chunks_var}.last().usage())")
407 }
408 "php" => {
409 format!("(!empty(${chunks_var}) ? end(${chunks_var})->usage ?? null : null)")
410 }
411 "elixir" => {
412 format!("(if length({chunks_var}) > 0, do: List.last({chunks_var}).usage, else: nil)")
413 }
414 _ => {
415 format!("({chunks_var}.length > 0 ? {chunks_var}[{chunks_var}.length - 1].usage : undefined)")
416 }
417 }),
418
419 _ => {
420 if let Some((root, tail)) = split_streaming_deep_path(field) {
424 if lang == "rust" && root == "tool_calls" {
428 return Some(render_rust_tool_calls_deep(chunks_var, tail));
429 }
430 if lang == "zig" && root == "tool_calls" {
437 return None;
438 }
439 let root_expr = Self::accessor(root, lang, chunks_var)?;
440 Some(render_deep_tail(&root_expr, tail, lang))
441 } else {
442 None
443 }
444 }
445 }
446 }
447
448 pub fn collect_snippet(lang: &str, stream_var: &str, chunks_var: &str) -> Option<String> {
454 match lang {
455 "rust" => Some(format!(
456 "let {chunks_var}: Vec<_> = tokio_stream::StreamExt::collect::<Vec<_>>({stream_var}).await\n .into_iter()\n .map(|r| r.expect(\"stream item failed\"))\n .collect();"
457 )),
458 "go" => Some(format!(
459 "var {chunks_var} []pkg.ChatCompletionChunk\n\tfor chunk := range {stream_var} {{\n\t\t{chunks_var} = append({chunks_var}, chunk)\n\t}}"
460 )),
461 "java" => Some(format!(
462 "var {chunks_var} = new java.util.ArrayList<ChatCompletionChunk>();\n var _it = {stream_var};\n while (_it.hasNext()) {{ {chunks_var}.add(_it.next()); }}"
463 )),
464 "php" => Some(format!(
471 "${chunks_var} = is_string(${stream_var}) ? (json_decode(${stream_var}) ?: []) : iterator_to_array(${stream_var});"
472 )),
473 "python" => Some(format!(
474 "{chunks_var} = []\n async for chunk in {stream_var}:\n {chunks_var}.append(chunk)"
475 )),
476 "kotlin" => {
477 Some(format!("val {chunks_var} = {stream_var}.asSequence().toList()"))
480 }
481 "elixir" => Some(format!("{chunks_var} = Enum.to_list({stream_var})")),
482 "node" | "wasm" | "typescript" => Some(format!(
483 "const {chunks_var}: any[] = [];\n for await (const _chunk of {stream_var}) {{ {chunks_var}.push(_chunk); }}"
484 )),
485 "zig" => {
486 Some(format!(
493 concat!(
494 "var {chunks_var}: std.ArrayList([]u8) = .empty;
495",
496 " defer {{
497",
498 " for ({chunks_var}.items) |_cj| std.heap.c_allocator.free(_cj);
499",
500 " {chunks_var}.deinit(std.heap.c_allocator);
501",
502 " }}
503",
504 " var {chunks_var}_content: std.ArrayList(u8) = .empty;
505",
506 " defer {chunks_var}_content.deinit(std.heap.c_allocator);
507",
508 " while (true) {{
509",
510 " const _nc = liter_llm.c.literllm_default_client_chat_stream_next({stream_var});
511",
512 " if (_nc == null) break;
513",
514 " const _np = liter_llm.c.literllm_chat_completion_chunk_to_json(_nc);
515",
516 " liter_llm.c.literllm_chat_completion_chunk_free(_nc);
517",
518 " if (_np == null) continue;
519",
520 " const _ns = std.mem.span(_np);
521",
522 " const _nj = try std.heap.c_allocator.dupe(u8, _ns);
523",
524 " liter_llm.c.literllm_free_string(_np);
525",
526 " if (std.json.parseFromSlice(std.json.Value, std.heap.c_allocator, _nj, .{{}})) |_cp| {{
527",
528 " defer _cp.deinit();
529",
530 " if (_cp.value.object.get(\"choices\")) |_chs|
531",
532 " if (_chs.array.items.len > 0)
533",
534 " if (_chs.array.items[0].object.get(\"delta\")) |_dl|
535",
536 " if (_dl.object.get(\"content\")) |_ct|
537",
538 " if (_ct == .string) try {chunks_var}_content.appendSlice(std.heap.c_allocator, _ct.string);
539",
540 " }} else |_| {{}}
541",
542 " try {chunks_var}.append(std.heap.c_allocator, _nj);
543",
544 " }}"
545 ),
546 chunks_var = chunks_var,
547 stream_var = stream_var,
548 ))
549 }
550 _ => None,
551 }
552 }
553}
554
555fn render_rust_tool_calls_deep(chunks_var: &str, tail: &str) -> String {
559 let segs = parse_tail(tail);
560 let idx = segs.iter().find_map(|s| match s {
562 TailSeg::Index(n) => Some(*n),
563 _ => None,
564 });
565 let field_segs: Vec<&str> = segs
566 .iter()
567 .filter_map(|s| match s {
568 TailSeg::Field(f) => Some(f.as_str()),
569 _ => None,
570 })
571 .collect();
572
573 let base = format!(
574 "{chunks_var}.iter().flat_map(|c| c.choices.iter().flat_map(|ch| ch.delta.tool_calls.iter().flatten()))"
575 );
576 let with_nth = match idx {
577 Some(n) => format!("{base}.nth({n})"),
578 None => base,
579 };
580
581 let mut expr = with_nth;
584 for (i, f) in field_segs.iter().enumerate() {
585 let is_leaf = i == field_segs.len() - 1;
586 if is_leaf {
587 expr = format!("{expr}.and_then(|x| x.{f}.as_deref())");
588 } else {
589 expr = format!("{expr}.and_then(|x| x.{f}.as_ref())");
590 }
591 }
592 format!("{expr}.unwrap_or(\"\")")
593}
594
595#[derive(Debug, PartialEq)]
600enum TailSeg {
601 Index(usize),
602 Field(String),
603}
604
605fn parse_tail(tail: &str) -> Vec<TailSeg> {
606 let mut segs = Vec::new();
607 let mut rest = tail;
608 while !rest.is_empty() {
609 if let Some(inner) = rest.strip_prefix('[') {
610 if let Some(close) = inner.find(']') {
612 let idx_str = &inner[..close];
613 if let Ok(idx) = idx_str.parse::<usize>() {
614 segs.push(TailSeg::Index(idx));
615 }
616 rest = &inner[close + 1..];
617 } else {
618 break;
619 }
620 } else if let Some(inner) = rest.strip_prefix('.') {
621 let end = inner.find(['.', '[']).unwrap_or(inner.len());
623 segs.push(TailSeg::Field(inner[..end].to_string()));
624 rest = &inner[end..];
625 } else {
626 break;
627 }
628 }
629 segs
630}
631
632fn render_deep_tail(root_expr: &str, tail: &str, lang: &str) -> String {
635 use heck::{ToLowerCamelCase, ToPascalCase};
636
637 let segs = parse_tail(tail);
638 let mut out = root_expr.to_string();
639
640 for seg in &segs {
641 match (seg, lang) {
642 (TailSeg::Index(n), "rust") => {
643 out = format!("({out})[{n}]");
644 }
645 (TailSeg::Index(n), "java") => {
646 out = format!("({out}).get({n})");
647 }
648 (TailSeg::Index(n), "kotlin") => {
649 if *n == 0 {
650 out = format!("({out}).first()");
651 } else {
652 out = format!("({out}).get({n})");
653 }
654 }
655 (TailSeg::Index(n), "elixir") => {
656 out = format!("Enum.at({out}, {n})");
657 }
658 (TailSeg::Index(n), "zig") => {
659 out = format!("({out}).items[{n}]");
660 }
661 (TailSeg::Index(n), "php") => {
662 out = format!("({out})[{n}]");
663 }
664 (TailSeg::Index(n), _) => {
665 out = format!("({out})[{n}]");
667 }
668 (TailSeg::Field(f), "rust") => {
669 use heck::ToSnakeCase;
670 out.push('.');
671 out.push_str(&f.to_snake_case());
672 }
673 (TailSeg::Field(f), "go") => {
674 use alef_codegen::naming::to_go_name;
675 out.push('.');
676 out.push_str(&to_go_name(f));
677 }
678 (TailSeg::Field(f), "java") => {
679 out.push('.');
680 out.push_str(&f.to_lower_camel_case());
681 out.push_str("()");
682 }
683 (TailSeg::Field(f), "kotlin") => {
684 out.push('.');
685 out.push_str(&f.to_lower_camel_case());
686 out.push_str("()");
687 }
688 (TailSeg::Field(f), "csharp") => {
689 out.push('.');
690 out.push_str(&f.to_pascal_case());
691 }
692 (TailSeg::Field(f), "php") => {
693 out.push_str("->");
698 out.push_str(f);
699 }
700 (TailSeg::Field(f), "elixir") => {
701 out.push('.');
702 out.push_str(f);
703 }
704 (TailSeg::Field(f), "zig") => {
705 out.push('.');
706 out.push_str(f);
707 }
708 (TailSeg::Field(f), "python") | (TailSeg::Field(f), "ruby") => {
709 out.push('.');
710 out.push_str(f);
711 }
712 (TailSeg::Field(f), _) => {
714 out.push('.');
715 out.push_str(&f.to_lower_camel_case());
716 }
717 }
718 }
719
720 out
721}
722
723#[cfg(test)]
724mod tests {
725 use super::*;
726
727 #[test]
728 fn is_streaming_virtual_field_recognizes_all_fields() {
729 for field in STREAMING_VIRTUAL_FIELDS {
730 assert!(
731 is_streaming_virtual_field(field),
732 "field '{field}' not recognized as streaming virtual"
733 );
734 }
735 }
736
737 #[test]
738 fn is_streaming_virtual_field_rejects_real_fields() {
739 assert!(!is_streaming_virtual_field("content"));
740 assert!(!is_streaming_virtual_field("choices"));
741 assert!(!is_streaming_virtual_field("model"));
742 assert!(!is_streaming_virtual_field(""));
743 }
744
745 #[test]
746 fn is_streaming_virtual_field_rejects_non_root_paths_with_matching_tail() {
747 assert!(!is_streaming_virtual_field("choices[0].finish_reason"));
752 assert!(!is_streaming_virtual_field("choices[0].message.content"));
753 assert!(!is_streaming_virtual_field("data[0].embedding"));
754 }
755
756 #[test]
757 fn is_streaming_virtual_field_does_not_match_usage() {
758 assert!(!is_streaming_virtual_field("usage"));
762 assert!(!is_streaming_virtual_field("usage.total_tokens"));
763 assert!(!is_streaming_virtual_field("usage.prompt_tokens"));
764 }
765
766 #[test]
767 fn accessor_chunks_returns_var_name() {
768 assert_eq!(
769 StreamingFieldResolver::accessor("chunks", "rust", "chunks"),
770 Some("chunks".to_string())
771 );
772 assert_eq!(
773 StreamingFieldResolver::accessor("chunks", "node", "chunks"),
774 Some("chunks".to_string())
775 );
776 }
777
778 #[test]
779 fn accessor_chunks_length_uses_language_idiom() {
780 let rust = StreamingFieldResolver::accessor("chunks.length", "rust", "chunks").unwrap();
781 assert!(rust.contains(".len()"), "rust: {rust}");
782
783 let go = StreamingFieldResolver::accessor("chunks.length", "go", "chunks").unwrap();
784 assert!(go.starts_with("len("), "go: {go}");
785
786 let node = StreamingFieldResolver::accessor("chunks.length", "node", "chunks").unwrap();
787 assert!(node.contains(".length"), "node: {node}");
788
789 let php = StreamingFieldResolver::accessor("chunks.length", "php", "chunks").unwrap();
790 assert!(php.starts_with("count("), "php: {php}");
791 }
792
793 #[test]
794 fn accessor_chunks_length_zig_uses_items_len() {
795 let zig = StreamingFieldResolver::accessor("chunks.length", "zig", "chunks").unwrap();
796 assert_eq!(zig, "chunks.items.len", "zig chunks.length: {zig}");
797 }
798
799 #[test]
800 fn accessor_stream_content_zig_uses_content_items() {
801 let zig = StreamingFieldResolver::accessor("stream_content", "zig", "chunks").unwrap();
802 assert_eq!(zig, "chunks_content.items", "zig stream_content: {zig}");
803 }
804
805 #[test]
806 fn collect_snippet_zig_drains_via_ffi() {
807 let snip = StreamingFieldResolver::collect_snippet("zig", "_stream_handle", "chunks").unwrap();
808 assert!(snip.contains("std.ArrayList([]u8)"), "zig collect: {snip}");
809 assert!(snip.contains("chat_stream_next(_stream_handle)"), "zig collect: {snip}");
810 assert!(snip.contains("chunks_content"), "zig collect: {snip}");
811 assert!(
812 snip.contains("chunks.append(std.heap.c_allocator"),
813 "zig collect: {snip}"
814 );
815 assert!(snip.contains(".empty;"), "zig collect (Zig 0.16 unmanaged): {snip}");
816 }
817
818 #[test]
819 fn accessor_stream_content_rust_uses_iterator() {
820 let expr = StreamingFieldResolver::accessor("stream_content", "rust", "chunks").unwrap();
821 assert!(expr.contains(".collect::<String>()"), "rust stream_content: {expr}");
822 }
823
824 #[test]
825 fn accessor_no_chunks_after_done_returns_true() {
826 for lang in ["rust", "go", "java", "php", "node", "wasm", "elixir"] {
827 let expr = StreamingFieldResolver::accessor("no_chunks_after_done", lang, "chunks").unwrap();
828 assert_eq!(expr, "true", "lang {lang}: expected 'true', got '{expr}'");
829 }
830 }
831
832 #[test]
833 fn accessor_elixir_chunks_length_uses_length_function() {
834 let expr = StreamingFieldResolver::accessor("chunks.length", "elixir", "chunks").unwrap();
835 assert_eq!(expr, "length(chunks)", "elixir chunks.length: {expr}");
836 }
837
838 #[test]
839 fn accessor_elixir_stream_content_uses_pipe() {
840 let expr = StreamingFieldResolver::accessor("stream_content", "elixir", "chunks").unwrap();
841 assert!(expr.contains("|> Enum.join"), "elixir stream_content: {expr}");
842 assert!(expr.contains("|> Enum.map"), "elixir stream_content: {expr}");
843 assert!(
845 !expr.contains("choices[0]"),
846 "elixir stream_content must not use bracket access on list: {expr}"
847 );
848 assert!(
849 expr.contains("Enum.at("),
850 "elixir stream_content must use Enum.at for list index: {expr}"
851 );
852 }
853
854 #[test]
855 fn accessor_elixir_stream_complete_uses_list_last() {
856 let expr = StreamingFieldResolver::accessor("stream_complete", "elixir", "chunks").unwrap();
857 assert!(expr.contains("List.last(chunks)"), "elixir stream_complete: {expr}");
858 assert!(expr.contains("finish_reason != nil"), "elixir stream_complete: {expr}");
859 assert!(
861 !expr.contains("choices[0]"),
862 "elixir stream_complete must not use bracket access on list: {expr}"
863 );
864 assert!(
865 expr.contains("Enum.at("),
866 "elixir stream_complete must use Enum.at for list index: {expr}"
867 );
868 }
869
870 #[test]
871 fn accessor_elixir_finish_reason_uses_list_last() {
872 let expr = StreamingFieldResolver::accessor("finish_reason", "elixir", "chunks").unwrap();
873 assert!(expr.contains("List.last(chunks)"), "elixir finish_reason: {expr}");
874 assert!(expr.contains("finish_reason"), "elixir finish_reason: {expr}");
875 assert!(
877 !expr.contains("choices[0]"),
878 "elixir finish_reason must not use bracket access on list: {expr}"
879 );
880 assert!(
881 expr.contains("Enum.at("),
882 "elixir finish_reason must use Enum.at for list index: {expr}"
883 );
884 }
885
886 #[test]
887 fn collect_snippet_elixir_uses_enum_to_list() {
888 let snip = StreamingFieldResolver::collect_snippet("elixir", "result", "chunks").unwrap();
889 assert!(snip.contains("Enum.to_list(result)"), "elixir: {snip}");
890 assert!(snip.contains("chunks ="), "elixir: {snip}");
891 }
892
893 #[test]
894 fn collect_snippet_rust_uses_tokio_stream() {
895 let snip = StreamingFieldResolver::collect_snippet("rust", "result", "chunks").unwrap();
896 assert!(snip.contains("tokio_stream::StreamExt::collect"), "rust: {snip}");
897 assert!(snip.contains("let chunks"), "rust: {snip}");
898 assert!(snip.contains(".expect("), "rust must unwrap Result items: {snip}");
900 }
901
902 #[test]
903 fn collect_snippet_go_drains_channel() {
904 let snip = StreamingFieldResolver::collect_snippet("go", "stream", "chunks").unwrap();
905 assert!(snip.contains("for chunk := range stream"), "go: {snip}");
906 }
907
908 #[test]
909 fn collect_snippet_java_uses_iterator() {
910 let snip = StreamingFieldResolver::collect_snippet("java", "result", "chunks").unwrap();
911 assert!(snip.contains("hasNext()"), "java: {snip}");
912 }
913
914 #[test]
915 fn collect_snippet_php_decodes_json_or_iterates() {
916 let snip = StreamingFieldResolver::collect_snippet("php", "result", "chunks").unwrap();
917 assert!(snip.contains("json_decode"), "php must decode JSON: {snip}");
922 assert!(
923 snip.contains("iterator_to_array"),
924 "php must keep iterator_to_array fallback: {snip}"
925 );
926 assert!(snip.contains("$chunks ="), "php must bind $chunks: {snip}");
927 }
928
929 #[test]
930 fn collect_snippet_node_uses_for_await() {
931 let snip = StreamingFieldResolver::collect_snippet("node", "result", "chunks").unwrap();
932 assert!(snip.contains("for await"), "node: {snip}");
933 }
934
935 #[test]
936 fn collect_snippet_python_uses_async_for() {
937 let snip = StreamingFieldResolver::collect_snippet("python", "result", "chunks").unwrap();
938 assert!(snip.contains("async for chunk in result"), "python: {snip}");
939 assert!(snip.contains("chunks.append(chunk)"), "python: {snip}");
940 }
941
942 #[test]
943 fn accessor_stream_content_python_uses_join() {
944 let expr = StreamingFieldResolver::accessor("stream_content", "python", "chunks").unwrap();
945 assert!(expr.contains("\"\".join("), "python stream_content: {expr}");
946 assert!(expr.contains("c.choices"), "python stream_content: {expr}");
947 }
948
949 #[test]
950 fn accessor_stream_complete_python_uses_finish_reason() {
951 let expr = StreamingFieldResolver::accessor("stream_complete", "python", "chunks").unwrap();
952 assert!(
953 expr.contains("finish_reason is not None"),
954 "python stream_complete: {expr}"
955 );
956 }
957
958 #[test]
959 fn accessor_finish_reason_python_uses_last_chunk() {
960 let expr = StreamingFieldResolver::accessor("finish_reason", "python", "chunks").unwrap();
961 assert!(expr.contains("chunks[-1]"), "python finish_reason: {expr}");
962 assert!(
964 expr.starts_with("(str(") || expr.contains("str(chunks"),
965 "python finish_reason must wrap in str(): {expr}"
966 );
967 }
968
969 #[test]
970 fn accessor_tool_calls_python_uses_list_comprehension() {
971 let expr = StreamingFieldResolver::accessor("tool_calls", "python", "chunks").unwrap();
972 assert!(expr.contains("for c in chunks"), "python tool_calls: {expr}");
973 assert!(expr.contains("tool_calls"), "python tool_calls: {expr}");
974 }
975
976 #[test]
977 fn accessor_usage_python_uses_last_chunk() {
978 let expr = StreamingFieldResolver::accessor("usage", "python", "chunks").unwrap();
979 assert!(
980 expr.contains("chunks[-1].usage"),
981 "python usage: expected chunks[-1].usage, got: {expr}"
982 );
983 }
984
985 #[test]
986 fn accessor_usage_total_tokens_does_not_route_via_chunks() {
987 assert!(StreamingFieldResolver::accessor("usage.total_tokens", "python", "chunks").is_none());
991 }
992
993 #[test]
994 fn accessor_unknown_field_returns_none() {
995 assert_eq!(
996 StreamingFieldResolver::accessor("nonexistent_field", "rust", "chunks"),
997 None
998 );
999 }
1000
1001 #[test]
1006 fn is_streaming_virtual_field_recognizes_deep_tool_calls_paths() {
1007 assert!(
1008 is_streaming_virtual_field("tool_calls[0].function.name"),
1009 "tool_calls[0].function.name should be recognized"
1010 );
1011 assert!(
1012 is_streaming_virtual_field("tool_calls[0].id"),
1013 "tool_calls[0].id should be recognized"
1014 );
1015 assert!(
1016 is_streaming_virtual_field("tool_calls[1].function.arguments"),
1017 "tool_calls[1].function.arguments should be recognized"
1018 );
1019 assert!(is_streaming_virtual_field("tool_calls"));
1021 assert!(!is_streaming_virtual_field("tool_calls_extra.name"));
1023 assert!(!is_streaming_virtual_field("nonexistent[0].field"));
1024 }
1025
1026 #[test]
1033 fn deep_tool_calls_function_name_snapshot_rust_kotlin_ts() {
1034 let field = "tool_calls[0].function.name";
1035
1036 let rust = StreamingFieldResolver::accessor(field, "rust", "chunks").unwrap();
1037 assert!(
1041 rust.contains(".nth(0)"),
1042 "rust deep tool_calls: expected .nth(0) iterator index, got: {rust}"
1043 );
1044 assert!(
1045 rust.contains("x.function.as_ref()"),
1046 "rust deep tool_calls: expected Option-aware function access, got: {rust}"
1047 );
1048 assert!(
1049 rust.contains("x.name.as_deref()"),
1050 "rust deep tool_calls: expected Option-aware name leaf, got: {rust}"
1051 );
1052 assert!(
1053 !rust.contains("// skipped"),
1054 "rust deep tool_calls: must not emit skip comment, got: {rust}"
1055 );
1056
1057 let kotlin = StreamingFieldResolver::accessor(field, "kotlin", "chunks").unwrap();
1058 assert!(
1060 kotlin.contains(".first()"),
1061 "kotlin deep tool_calls: expected .first() for index 0, got: {kotlin}"
1062 );
1063 assert!(
1064 kotlin.contains(".function()"),
1065 "kotlin deep tool_calls: expected .function() method call, got: {kotlin}"
1066 );
1067 assert!(
1068 kotlin.contains(".name()"),
1069 "kotlin deep tool_calls: expected .name() method call, got: {kotlin}"
1070 );
1071
1072 let ts = StreamingFieldResolver::accessor(field, "node", "chunks").unwrap();
1073 assert!(
1075 ts.contains("[0]"),
1076 "ts/node deep tool_calls: expected [0] index, got: {ts}"
1077 );
1078 assert!(
1079 ts.contains(".function"),
1080 "ts/node deep tool_calls: expected .function segment, got: {ts}"
1081 );
1082 assert!(
1083 ts.contains(".name"),
1084 "ts/node deep tool_calls: expected .name segment, got: {ts}"
1085 );
1086 }
1087
1088 #[test]
1089 fn deep_tool_calls_id_snapshot_all_langs() {
1090 let field = "tool_calls[0].id";
1091
1092 let rust = StreamingFieldResolver::accessor(field, "rust", "chunks").unwrap();
1093 assert!(rust.contains(".nth(0)"), "rust: {rust}");
1094 assert!(rust.contains("x.id.as_deref()"), "rust: {rust}");
1095
1096 let go = StreamingFieldResolver::accessor(field, "go", "chunks").unwrap();
1097 assert!(go.contains("[0]"), "go: {go}");
1098 assert!(go.contains(".ID"), "go: expected .ID initialism, got: {go}");
1100
1101 let python = StreamingFieldResolver::accessor(field, "python", "chunks").unwrap();
1102 assert!(python.contains("[0]"), "python: {python}");
1103 assert!(python.contains(".id"), "python: {python}");
1104
1105 let php = StreamingFieldResolver::accessor(field, "php", "chunks").unwrap();
1106 assert!(php.contains("[0]"), "php: {php}");
1107 assert!(php.contains("->id"), "php: expected ->id, got: {php}");
1108
1109 let java = StreamingFieldResolver::accessor(field, "java", "chunks").unwrap();
1110 assert!(java.contains(".get(0)"), "java: expected .get(0), got: {java}");
1111 assert!(java.contains(".id()"), "java: expected .id() method call, got: {java}");
1112
1113 let csharp = StreamingFieldResolver::accessor(field, "csharp", "chunks").unwrap();
1114 assert!(csharp.contains("[0]"), "csharp: {csharp}");
1115 assert!(
1116 csharp.contains(".Id"),
1117 "csharp: expected .Id (PascalCase), got: {csharp}"
1118 );
1119
1120 let elixir = StreamingFieldResolver::accessor(field, "elixir", "chunks").unwrap();
1121 assert!(elixir.contains("Enum.at("), "elixir: expected Enum.at(, got: {elixir}");
1122 assert!(elixir.contains(".id"), "elixir: {elixir}");
1123 }
1124
1125 #[test]
1126 fn deep_tool_calls_function_name_snapshot_python_elixir_zig() {
1127 let field = "tool_calls[0].function.name";
1128
1129 let python = StreamingFieldResolver::accessor(field, "python", "chunks").unwrap();
1130 assert!(python.contains("[0]"), "python: {python}");
1131 assert!(python.contains(".function"), "python: {python}");
1132 assert!(python.contains(".name"), "python: {python}");
1133
1134 let elixir = StreamingFieldResolver::accessor(field, "elixir", "chunks").unwrap();
1135 assert!(elixir.contains("Enum.at("), "elixir: {elixir}");
1137 assert!(elixir.contains(".function"), "elixir: {elixir}");
1138 assert!(elixir.contains(".name"), "elixir: {elixir}");
1139
1140 assert!(
1144 StreamingFieldResolver::accessor(field, "zig", "chunks").is_none(),
1145 "zig: expected None for deep tool_calls path"
1146 );
1147 }
1148
1149 #[test]
1150 fn parse_tail_parses_index_then_field_segments() {
1151 let segs = parse_tail("[0].function.name");
1152 assert_eq!(segs.len(), 3, "expected 3 segments, got: {segs:?}");
1153 assert_eq!(segs[0], TailSeg::Index(0));
1154 assert_eq!(segs[1], TailSeg::Field("function".to_string()));
1155 assert_eq!(segs[2], TailSeg::Field("name".to_string()));
1156 }
1157
1158 #[test]
1159 fn parse_tail_parses_simple_index_field() {
1160 let segs = parse_tail("[0].id");
1161 assert_eq!(segs.len(), 2, "expected 2 segments, got: {segs:?}");
1162 assert_eq!(segs[0], TailSeg::Index(0));
1163 assert_eq!(segs[1], TailSeg::Field("id".to_string()));
1164 }
1165
1166 #[test]
1167 fn parse_tail_handles_nonzero_index() {
1168 let segs = parse_tail("[2].function.arguments");
1169 assert_eq!(segs[0], TailSeg::Index(2));
1170 assert_eq!(segs[1], TailSeg::Field("function".to_string()));
1171 assert_eq!(segs[2], TailSeg::Field("arguments".to_string()));
1172 }
1173}