feat: expand DSML tool-call alias and fence handling

Add support for DSML wrapper aliases (<dsml|tool_calls>, <|tool_calls>,
<|tool_calls>) alongside canonical XML. Normalize mixed DSML/canonical
tags instead of rejecting them. Add tilde fence (~~~) support, fix
nested fence and unclosed fence handling, support CDATA-protected fence
content, and skip prose mentions when scanning for real tool blocks.
Mirror all changes between Go and Node.js runtimes.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
CJACK
2026-04-27 13:39:50 +08:00
parent 90ce595325
commit a13293e113
19 changed files with 1524 additions and 125 deletions

View File

@@ -0,0 +1,556 @@
package toolstream
import (
"strings"
"testing"
)
// ---- 错位工具块 ----
// 只有 </tool_calls> 没有 <tool_calls>
func TestSieve_MismatchedClose_OnlyClosingTag(t *testing.T) {
var state State
chunks := []string{
"一些正文内容\n",
"</tool_calls>\n",
"后续内容",
}
var events []Event
for _, c := range chunks {
events = append(events, ProcessChunk(&state, c, []string{"read_file"})...)
}
events = append(events, Flush(&state, []string{"read_file"})...)
var text strings.Builder
tc := 0
for _, e := range events {
text.WriteString(e.Content)
tc += len(e.ToolCalls)
}
if tc != 0 {
t.Fatalf("孤立闭合标签不应触发工具调用got %d", tc)
}
if !strings.Contains(text.String(), "一些正文") || !strings.Contains(text.String(), "后续内容") {
t.Fatalf("应保留所有文本, got %q", text.String())
}
}
// <tool_calls> 打开后跟的不是 <invoke> 而是普通文本
func TestSieve_ToolCallsWrapperWithNoInvoke(t *testing.T) {
var state State
chunks := []string{
"<tool_calls>\n",
"这里没有 invoke 标签\n",
"</tool_calls>\n",
"后续内容",
}
var events []Event
for _, c := range chunks {
events = append(events, ProcessChunk(&state, c, []string{"read_file"})...)
}
events = append(events, Flush(&state, []string{"read_file"})...)
var text strings.Builder
tc := 0
for _, e := range events {
text.WriteString(e.Content)
tc += len(e.ToolCalls)
}
if tc != 0 {
t.Fatalf("无 invoke 不应触发工具调用got %d", tc)
}
}
// 两个连续工具调用块
func TestSieve_TwoConsecutiveToolCallBlocks(t *testing.T) {
var state State
chunks := []string{
`<tool_calls><invoke name="read_file"><parameter name="path">a.txt</parameter></invoke></tool_calls>`,
"\n",
`<tool_calls><invoke name="read_file"><parameter name="path">b.txt</parameter></invoke></tool_calls>`,
}
var events []Event
for _, c := range chunks {
events = append(events, ProcessChunk(&state, c, []string{"read_file"})...)
}
events = append(events, Flush(&state, []string{"read_file"})...)
tc := 0
for _, e := range events {
tc += len(e.ToolCalls)
}
if tc != 2 {
t.Fatalf("应解析出两个工具调用got %d, events=%#v", tc, events)
}
}
// ---- 围栏内的工具调用不应触发 ----
// 反引号围栏内有完整工具调用 + 围栏外有真正的工具调用
func TestSieve_FencedExampleThenRealToolCall(t *testing.T) {
var state State
chunks := []string{
"示例:\n```xml\n",
`<tool_calls><invoke name="fake"><parameter name="x">1</parameter></invoke></tool_calls>`,
"\n```\n",
`<tool_calls><invoke name="read_file"><parameter name="path">real.txt</parameter></invoke></tool_calls>`,
}
var events []Event
for _, c := range chunks {
events = append(events, ProcessChunk(&state, c, []string{"read_file", "fake"})...)
}
events = append(events, Flush(&state, []string{"read_file", "fake"})...)
var text strings.Builder
tc := 0
var names []string
for _, e := range events {
text.WriteString(e.Content)
for _, call := range e.ToolCalls {
tc++
names = append(names, call.Name)
}
}
if tc != 1 {
t.Fatalf("应只触发围栏外的工具调用got %d, names=%v", tc, names)
}
if names[0] != "read_file" {
t.Fatalf("应触发 read_filegot %v", names)
}
if !strings.Contains(text.String(), "示例") {
t.Fatalf("围栏前文本应保留, got %q", text.String())
}
}
// 波浪线围栏包裹工具调用
func TestSieve_TildeFencedToolCallIgnored(t *testing.T) {
var state State
chunks := []string{
"~~~\n",
`<tool_calls><invoke name="read_file"><parameter name="path">x</parameter></invoke></tool_calls>`,
"\n~~~\n",
"结束",
}
var events []Event
for _, c := range chunks {
events = append(events, ProcessChunk(&state, c, []string{"read_file"})...)
}
events = append(events, Flush(&state, []string{"read_file"})...)
tc := 0
var text strings.Builder
for _, e := range events {
text.WriteString(e.Content)
tc += len(e.ToolCalls)
}
if tc != 0 {
t.Fatalf("波浪线围栏内工具调用不应触发got %d", tc)
}
if !strings.Contains(text.String(), "结束") {
t.Fatalf("围栏后文本应保留, got %q", text.String())
}
}
// 4 反引号嵌套 3 反引号,内含工具标签
func TestSieve_FourBacktickNestedThreeWithToolCall(t *testing.T) {
var state State
chunks := []string{
"````markdown\n",
"```xml\n",
`<tool_calls><invoke name="read_file"><parameter name="path">x</parameter></invoke></tool_calls>`,
"\n```\n",
"````\n",
"外部文本",
}
var events []Event
for _, c := range chunks {
events = append(events, ProcessChunk(&state, c, []string{"read_file"})...)
}
events = append(events, Flush(&state, []string{"read_file"})...)
tc := 0
var text strings.Builder
for _, e := range events {
text.WriteString(e.Content)
tc += len(e.ToolCalls)
}
if tc != 0 {
t.Fatalf("4反引号嵌套内的工具调用不应触发got %d", tc)
}
if !strings.Contains(text.String(), "外部文本") {
t.Fatalf("围栏外文本应保留, got %q", text.String())
}
}
// ---- DSML 变体在围栏内不触发 ----
func TestSieve_DSMLInsideFenceIgnored(t *testing.T) {
var state State
chunks := []string{
"```\n",
"<|DSML|tool_calls>\n",
`<|DSML|invoke name="read_file">`,
`<|DSML|parameter name="path">x</|DSML|parameter>`,
"</|DSML|invoke>\n",
"</|DSML|tool_calls>\n",
"```\n",
"结束",
}
var events []Event
for _, c := range chunks {
events = append(events, ProcessChunk(&state, c, []string{"read_file"})...)
}
events = append(events, Flush(&state, []string{"read_file"})...)
tc := 0
for _, e := range events {
tc += len(e.ToolCalls)
}
if tc != 0 {
t.Fatalf("围栏内的 DSML 工具调用不应触发got %d", tc)
}
}
// ---- 工具调用前后有丰富文本 ----
func TestSieve_RichTextAroundToolCall(t *testing.T) {
var state State
chunks := []string{
"我来帮你查看文件内容。\n\n",
"首先读取 README\n",
`<tool_calls><invoke name="read_file"><parameter name="path">README.md</parameter></invoke></tool_calls>`,
}
var events []Event
for _, c := range chunks {
events = append(events, ProcessChunk(&state, c, []string{"read_file"})...)
}
events = append(events, Flush(&state, []string{"read_file"})...)
var text strings.Builder
tc := 0
for _, e := range events {
text.WriteString(e.Content)
tc += len(e.ToolCalls)
}
if tc != 1 {
t.Fatalf("应有一个工具调用got %d", tc)
}
if !strings.Contains(text.String(), "帮你查看") {
t.Fatalf("前置文本丢失, got %q", text.String())
}
if strings.Contains(text.String(), "<invoke") {
t.Fatalf("工具标签泄漏, got %q", text.String())
}
}
// ---- 工具调用在 CDATA 包含代码围栏 ----
func TestSieve_ToolCallWithCDATAContainingFence(t *testing.T) {
var state State
payload := "```python\nprint('hello')\n```"
chunks := []string{
"<tool_calls>\n",
`<invoke name="write_file">` + "\n",
`<parameter name="path">test.md</parameter>` + "\n",
`<parameter name="content"><![CDATA[` + payload + `]]></parameter>` + "\n",
"</invoke>\n",
"</tool_calls>",
}
var events []Event
for _, c := range chunks {
events = append(events, ProcessChunk(&state, c, []string{"write_file"})...)
}
events = append(events, Flush(&state, []string{"write_file"})...)
var text strings.Builder
tc := 0
var gotContent any
for _, e := range events {
text.WriteString(e.Content)
if len(e.ToolCalls) > 0 {
tc += len(e.ToolCalls)
gotContent = e.ToolCalls[0].Input["content"]
}
}
if tc != 1 {
t.Fatalf("应有一个工具调用got %d", tc)
}
content, _ := gotContent.(string)
if content != payload {
t.Fatalf("CDATA 内围栏内容应完整保留got %q want %q", content, payload)
}
if text.Len() != 0 {
t.Fatalf("不应有文本泄漏, got %q", text.String())
}
}
// ---- 极端 token 拆分 ----
// 工具标签被拆成单字符流式到达
func TestSieve_CharByCharToolCall(t *testing.T) {
var state State
full := `<tool_calls><invoke name="read_file"><parameter name="path">go.mod</parameter></invoke></tool_calls>`
var events []Event
for _, ch := range full {
events = append(events, ProcessChunk(&state, string(ch), []string{"read_file"})...)
}
events = append(events, Flush(&state, []string{"read_file"})...)
var text strings.Builder
tc := 0
for _, e := range events {
text.WriteString(e.Content)
tc += len(e.ToolCalls)
}
if tc != 1 {
t.Fatalf("单字符流式应解析出工具调用got %d", tc)
}
if strings.Contains(text.String(), "invoke") {
t.Fatalf("标签泄漏, got %q", text.String())
}
}
// ---- 混合格式变体 ----
// 全宽竖线 wrapper + DSML invoke
func TestSieve_FullwidthPipeWrapperDSMLInvoke(t *testing.T) {
var state State
chunks := []string{
"<tool_calls>\n",
"<|DSML|invoke name=\"read_file\">\n",
"<|DSML|parameter name=\"path\">README.md</|DSML|parameter>\n",
"</|DSML|invoke>\n",
"</tool_calls>",
}
var events []Event
for _, c := range chunks {
events = append(events, ProcessChunk(&state, c, []string{"read_file"})...)
}
events = append(events, Flush(&state, []string{"read_file"})...)
var text strings.Builder
tc := 0
for _, e := range events {
text.WriteString(e.Content)
tc += len(e.ToolCalls)
}
if tc != 1 {
t.Fatalf("全宽+DSML混合应解析成功got %d", tc)
}
if strings.Contains(strings.ToLower(text.String()), "dsml") {
t.Fatalf("DSML 标签泄漏, got %q", text.String())
}
}
// ---- 未闭合工具块应回退为文本 ----
func TestSieve_UnclosedToolCallBlockFallsBack(t *testing.T) {
var state State
chunks := []string{
"<tool_calls>\n",
`<invoke name="read_file">` + "\n",
`<parameter name="path">README.md</parameter>` + "\n",
// 缺少 </invoke> 和 </tool_calls>
}
var events []Event
for _, c := range chunks {
events = append(events, ProcessChunk(&state, c, []string{"read_file"})...)
}
events = append(events, Flush(&state, []string{"read_file"})...)
var text strings.Builder
tc := 0
for _, e := range events {
text.WriteString(e.Content)
tc += len(e.ToolCalls)
}
// 未闭合的应回退为文本,不应丢失
if text.String() == "" {
t.Fatalf("未闭合工具块不应丢失所有内容")
}
if tc != 0 {
t.Fatalf("未闭合工具块不应解析出工具调用got %d", tc)
}
}
// ---- 文本中 mention 标签变体名 + 真正的工具调用 ----
// 模型输出 commit message 文本中包含 <dsml|tool_calls> 等 mention
// 紧随其后是真正的 DSML 工具调用。mention 的变体和实际工具调用变体不同。
func TestSieve_TagMentionInTextThenRealToolCall(t *testing.T) {
var state State
chunks := []string{
"建议的 commit message\n\nfeat: expand DSML alias support\n\n",
"Add support for <dsml|tool_calls>, ",
"<tool_calls> (fullwidth pipe),\n",
"and <|tool_calls> wrapper variants.\n\n",
"<|DSML|tool_calls>\n",
"<|DSML|invoke name=\"Bash\">\n",
"<|DSML|parameter name=\"command\"><![CDATA[git status]]></|DSML|parameter>\n",
"</|DSML|invoke>\n",
"</|DSML|tool_calls>",
}
var events []Event
for _, c := range chunks {
events = append(events, ProcessChunk(&state, c, []string{"Bash"})...)
}
events = append(events, Flush(&state, []string{"Bash"})...)
var text strings.Builder
tc := 0
var names []string
for _, e := range events {
text.WriteString(e.Content)
for _, call := range e.ToolCalls {
tc++
names = append(names, call.Name)
}
}
if tc != 1 {
t.Fatalf("应解析出 1 个工具调用got %d, text=%q", tc, text.String())
}
if names[0] != "Bash" {
t.Fatalf("应解析出 Bashgot %v", names)
}
if !strings.Contains(text.String(), "commit message") {
t.Fatalf("前置文本应保留, got %q", text.String())
}
}
func TestSieve_SameVariantTagMentionInTextThenRealToolCall(t *testing.T) {
var state State
chunks := []string{
"Summary: support canonical <tool_calls> and DSML <|DSML|tool_calls> wrappers.\n\n",
"<|DSML|tool_calls>\n",
"<|DSML|invoke name=\"Bash\">\n",
"<|DSML|parameter name=\"command\"><![CDATA[git status]]></|DSML|parameter>\n",
"</|DSML|invoke>\n",
"</|DSML|tool_calls>",
}
var events []Event
for _, c := range chunks {
events = append(events, ProcessChunk(&state, c, []string{"Bash"})...)
}
events = append(events, Flush(&state, []string{"Bash"})...)
var text strings.Builder
var callName string
var command string
callCount := 0
for _, e := range events {
text.WriteString(e.Content)
for _, call := range e.ToolCalls {
callCount++
callName = call.Name
command, _ = call.Input["command"].(string)
}
}
if callCount != 1 {
t.Fatalf("应解析出 1 个工具调用got %d, text=%q", callCount, text.String())
}
if callName != "Bash" {
t.Fatalf("应解析出 Bashgot %q", callName)
}
if command != "git status" {
t.Fatalf("应解析出 commandgot %q", command)
}
if !strings.Contains(text.String(), "Summary:") {
t.Fatalf("前置文本应保留, got %q", text.String())
}
}
func TestSieve_ReviewSampleWithAliasMentionsPreservesBodyAndToolCalls(t *testing.T) {
var state State
chunks := []string{
"Done reviewing the diff. Here's my analysis before we commit:\n\n",
"Summary of Changes\n",
"DSML wrapper variant support — recognize aliases (<dsml|tool_calls>, <|tool_calls>, <tool_calls>) alongside canonical <tool_calls> and <|DSML|tool_calls> wrappers.\n\n",
"<|DSML|tool_calls>\n",
"<|DSML|invoke name=\"Bash\">\n",
"<|DSML|parameter name=\"command\"><![CDATA[git add docs/toolcall-semantics.md internal/toolstream/tool_sieve_xml.go]]></|DSML|parameter>\n",
"<|DSML|parameter name=\"description\"><![CDATA[Stage all relevant changed files]]></|DSML|parameter>\n",
"</|DSML|invoke>\n",
"<|DSML|invoke name=\"Bash\">\n",
"<|DSML|parameter name=\"command\"><![CDATA[git commit -m \"$(cat <<'EOF'\nfeat(toolstream): expand DSML wrapper detection\n\nSupport DSML wrapper aliases: <dsml|tool_calls>, <|tool_calls>, <tool_calls> alongside existing canonical wrappers.\nEOF\n)\"]]></|DSML|parameter>\n",
"<|DSML|parameter name=\"description\"><![CDATA[Create commit with all staged changes]]></|DSML|parameter>\n",
"</|DSML|invoke>\n",
"</|DSML|tool_calls>",
}
var events []Event
for _, c := range chunks {
events = append(events, ProcessChunk(&state, c, []string{"Bash"})...)
}
events = append(events, Flush(&state, []string{"Bash"})...)
var text strings.Builder
var commands []string
for _, e := range events {
text.WriteString(e.Content)
for _, call := range e.ToolCalls {
if call.Name == "Bash" {
cmd, _ := call.Input["command"].(string)
commands = append(commands, cmd)
}
}
}
if len(commands) != 2 {
t.Fatalf("应解析出 2 个 Bash 工具调用got %d, text=%q", len(commands), text.String())
}
if !strings.Contains(text.String(), "<|DSML|tool_calls> wrappers") {
t.Fatalf("正文中的 DSML mention 应保留, got %q", text.String())
}
if !strings.Contains(text.String(), "Summary of Changes") {
t.Fatalf("前置正文应完整保留, got %q", text.String())
}
if strings.Contains(text.String(), "git add docs/toolcall-semantics.md") {
t.Fatalf("真实工具参数不应泄漏到正文, got %q", text.String())
}
if !strings.Contains(commands[0], "git add") || !strings.Contains(commands[1], "git commit") {
t.Fatalf("工具参数解析不符合预期, got %#v", commands)
}
}
func TestSieve_ChineseReviewSamplePreservesInlineDSMLMention(t *testing.T) {
var state State
chunks := []string{
"# Context from my IDE setup:\n\n## My request for Codex:\n",
"基于我的审查,这是工作区更改的总结和提交。\n\n## 审查报告\n\n### 文档\n\nAPI.md 中的工具调用部分缺少针对新 DSML 别名的更新——它只提到了 `",
"<|DSML|tool_calls>` 和 canonical `<tool_calls>`。由于这涉及 API 兼容性和文档准确性,需要在下游进行记录。\n\n",
"### 代码\n\n所有更改现在一致地处理四个 DSML wrapper 变体。\n\n现在提交已暂存的更改。\n\n",
"<|DSML|tool_calls>\n",
" <|DSML|invoke name=\"Bash\">\n",
" <|DSML|parameter name=\"command\"><![CDATA[git commit -m \"$(cat <<'EOF'\nfeat: expand DSML tool-call alias and fence handling\nEOF\n)\"]]></|DSML|parameter>\n",
" <|DSML|parameter name=\"description\"><![CDATA[Commit staged changes]]></|DSML|parameter>\n",
" </|DSML|invoke>\n",
"</|DSML|tool_calls>\n\n补充",
}
var events []Event
for _, c := range chunks {
events = append(events, ProcessChunk(&state, c, []string{"Bash"})...)
}
events = append(events, Flush(&state, []string{"Bash"})...)
var text strings.Builder
callCount := 0
for _, e := range events {
text.WriteString(e.Content)
callCount += len(e.ToolCalls)
}
if callCount != 1 {
t.Fatalf("应解析出 1 个工具调用got %d, text=%q", callCount, text.String())
}
want := "它只提到了 `<|DSML|tool_calls>` 和 canonical `<tool_calls>`。由于这涉及 API 兼容性"
if !strings.Contains(text.String(), want) {
t.Fatalf("正文不应在 inline DSML mention 处截断, want contains %q, got %q", want, text.String())
}
if !strings.Contains(text.String(), "补充") {
t.Fatalf("工具块后的正文应保留, got %q", text.String())
}
if strings.Contains(text.String(), "<|DSML|invoke") {
t.Fatalf("真实工具块不应泄漏到正文, got %q", text.String())
}
}