@ai-sdk-tool/parser 4.1.2 → 4.1.4

package/dist/community.cjs

@@ -3011,6 +3011,65 @@ function parse2(xml, schema, options = {}) {
   throw new RXMLParseError("Failed to parse XML with repair heuristics", error);
 }
 
+// src/core/prompts/shared/input-examples.ts
+function getToolInputExamples(tool) {
+  const inputExamples = tool.inputExamples;
+  if (!Array.isArray(inputExamples)) {
+    return [];
+  }
+  return inputExamples.filter(
+    (example) => typeof example === "object" && example !== null && "input" in example && example.input !== void 0
+  );
+}
+function safeStringifyInputExample(input, sourceError) {
+  try {
+    const serialized = JSON.stringify(input);
+    return serialized != null ? serialized : "null";
+  } catch (stringifyError) {
+    let reason = "";
+    if (sourceError instanceof Error) {
+      reason = sourceError.message;
+    } else if (stringifyError instanceof Error) {
+      reason = stringifyError.message;
+    }
+    return reason.length > 0 ? `[unserializable input: ${reason}]` : "[unserializable input]";
+  }
+}
+function stringifyInputExampleAsJsonLiteral(input) {
+  try {
+    const serialized = JSON.stringify(input);
+    return serialized != null ? serialized : "null";
+  } catch (error) {
+    const fallbackText = safeStringifyInputExample(input, error);
+    return JSON.stringify(fallbackText);
+  }
+}
+var INPUT_EXAMPLES_SECTION_HEADER = [
+  "# Input Examples",
+  "Treat these as canonical tool-call patterns.",
+  "Reuse the closest structure and nesting, change only values, and do not invent parameters.",
+  "Do not copy example values unless they match the user's request."
+];
+function renderInputExamplesSection(options) {
+  const renderedTools = options.tools.map((tool) => {
+    const inputExamples = getToolInputExamples(tool);
+    if (inputExamples.length === 0) {
+      return "";
+    }
+    const renderedExamples = inputExamples.map((example, index) => {
+      const rendered = options.renderExample(tool.name, example.input);
+      return `Example ${index + 1}:
+${rendered}`;
+    }).join("\n\n");
+    return `Tool: ${tool.name}
+${renderedExamples}`;
+  }).filter((text) => text.length > 0).join("\n\n");
+  if (renderedTools.length === 0) {
+    return "";
+  }
+  return [...INPUT_EXAMPLES_SECTION_HEADER, renderedTools].join("\n\n");
+}
+
 // src/core/prompts/shared/text-part.ts
 function toTextPart(text, providerOptions) {
   if (providerOptions === void 0) {
@@ -3234,29 +3293,6 @@ function renderToolForXmlPrompt(tool) {
   lines.push(`schema: ${stringifySchema(normalizedSchema)}`);
   return lines.join("\n");
 }
-function getToolInputExamples(tool) {
-  const inputExamples = tool.inputExamples;
-  if (!Array.isArray(inputExamples)) {
-    return [];
-  }
-  return inputExamples.filter(
-    (example) => typeof example === "object" && example !== null && "input" in example && example.input !== void 0
-  );
-}
-function safeStringifyInputExample(input, sourceError) {
-  try {
-    const serialized = JSON.stringify(input);
-    return serialized != null ? serialized : "null";
-  } catch (stringifyError) {
-    let reason = "";
-    if (sourceError instanceof Error) {
-      reason = sourceError.message;
-    } else if (stringifyError instanceof Error) {
-      reason = stringifyError.message;
-    }
-    return reason.length > 0 ? `[unserializable input: ${reason}]` : "[unserializable input]";
-  }
-}
 function renderMorphXmlInputExample(toolName, input) {
   try {
     return stringify(toolName, input, {
@@ -3271,29 +3307,10 @@ function renderMorphXmlInputExample(toolName, input) {
   }
 }
 function renderInputExamplesForXmlPrompt(tools) {
-  const renderedTools = tools.map((tool) => {
-    const inputExamples = getToolInputExamples(tool);
-    if (inputExamples.length === 0) {
-      return "";
-    }
-    const renderedExamples = inputExamples.map((example, index) => {
-      const xml = renderMorphXmlInputExample(tool.name, example.input);
-      return `Example ${index + 1}:
-${xml}`;
-    }).join("\n\n");
-    return `Tool: ${tool.name}
-${renderedExamples}`;
-  }).filter((text) => text.length > 0).join("\n\n");
-  if (renderedTools.length === 0) {
-    return "";
-  }
-  return [
-    "# Input Examples",
-    "Treat these as canonical tool-call patterns.",
-    "Reuse the closest structure and nesting, change only values, and do not invent parameters.",
-    "Do not copy example values unless they match the user's request.",
-    renderedTools
-  ].join("\n\n");
+  return renderInputExamplesSection({
+    tools,
+    renderExample: renderMorphXmlInputExample
+  });
 }
 function normalizeSchema(schema) {
   if (typeof schema === "string") {
@@ -3515,6 +3532,15 @@ function morphFormatToolResponseAsXml(toolResult) {
   return morphFormatToolResponseAsXmlWithOptions(toolResult);
 }
 
+// src/core/prompts/shared/xml-tag-name.ts
+var XML_TAG_NAME_REGEX = /^[A-Za-z_][A-Za-z0-9_.:-]*$/;
+function isValidXmlTagName(name) {
+  return XML_TAG_NAME_REGEX.test(name);
+}
+function toSafeXmlTagName(name) {
+  return isValidXmlTagName(name) ? name : "tool";
+}
+
 // src/rjson/index.ts
 var WHITESPACE_TEST_REGEX = /\s/;
 var WHITESPACE_REGEX4 = /^\s+/;
@@ -9994,11 +10020,28 @@ function renderToolDefinition(tool) {
 }
 function hermesSystemPromptTemplate(tools) {
   const toolsRendered = tools.map(renderToolDefinition).join("\n");
-  return `You are a function calling AI model. You are provided with function signatures within <tools></tools> XML tags. You may call one or more functions to assist with the user query. Don't make assumptions about what values to plug into functions. Here are the available tools: <tools> ${toolsRendered} </tools>
+  const basePrompt = `You are a function calling AI model. You are provided with function signatures within <tools></tools> XML tags. You may call one or more functions to assist with the user query. Don't make assumptions about what values to plug into functions. Here are the available tools: <tools> ${toolsRendered} </tools>
 Use the following pydantic model json schema for each tool call you will make: {"properties": {"name": {"title": "Name", "type": "string"}, "arguments": {"title": "Arguments", "type": "object"}}, "required": ["name", "arguments"], "title": "FunctionCall", "type": "object"}
 For each function call return a json object with function name and arguments within <tool_call></tool_call> XML tags as follows:
 <tool_call>
 {"name": "<function-name>", "arguments": <args-dict>}
+</tool_call>`;
+  const inputExamplesText = renderInputExamplesSection({
+    tools,
+    renderExample: renderHermesInputExample
+  });
+  if (inputExamplesText.length === 0) {
+    return basePrompt;
+  }
+  return `${basePrompt}
+
+${inputExamplesText}`;
+}
+function renderHermesInputExample(toolName, input) {
+  const argumentsLiteral = stringifyInputExampleAsJsonLiteral(input);
+  const nameLiteral = JSON.stringify(toolName);
+  return `<tool_call>
+{"name":${nameLiteral},"arguments":${argumentsLiteral}}
 </tool_call>`;
 }
 
@@ -10126,8 +10169,50 @@ function qwen3coderSystemPromptTemplate(tools) {
   }
   out += "\n</tools>";
   out += QWEN3CODER_TOOL_CALL_INSTRUCTIONS;
+  const inputExamplesText = renderInputExamplesSection({
+    tools,
+    renderExample: renderQwen3CoderInputExample
+  });
+  if (inputExamplesText.length > 0) {
+    out += `
+
+${inputExamplesText}`;
+  }
   return out;
 }
+function renderQwen3CoderInputExample(toolName, input) {
+  const parameterBlocks = renderQwen3CoderParameters(input);
+  return `<tool_call>
+<function=${escapeXmlMinimalAttr(toolName, '"')}>${parameterBlocks}
+</function>
+</tool_call>`;
+}
+function renderQwen3CoderParameters(input) {
+  if (isMapping2(input)) {
+    const lines = Object.entries(input).map(([key, value]) => {
+      const content = renderQwen3CoderParameterValue(value);
+      return `<parameter=${escapeXmlMinimalAttr(key, '"')}>
+${content}
+</parameter>`;
+    });
+    if (lines.length > 0) {
+      return `
+${lines.join("\n")}`;
+    }
+  }
+  const fallback = renderQwen3CoderParameterValue(input);
+  return `
+<parameter=input>
+${fallback}
+</parameter>`;
+}
+function renderQwen3CoderParameterValue(value) {
+  if (typeof value === "string") {
+    return escapeXmlMinimalText(value);
+  }
+  const serialized = safeStringifyInputExample(value);
+  return escapeXmlMinimalText(serialized);
+}
 function stringifyToolResponseContent(value) {
   if (typeof value === "string") {
     return value;
@@ -10149,8 +10234,13 @@ function formatToolResponseAsQwen3CoderXml(toolResult) {
 }
 
 // src/core/prompts/yaml-xml-prompt.ts
+var import_yaml2 = __toESM(require("yaml"), 1);
 function yamlXmlSystemPromptTemplate(tools, includeMultilineExample = true) {
   const toolsJson = JSON.stringify(tools);
+  const inputExamplesText = renderInputExamplesSection({
+    tools,
+    renderExample: renderYamlXmlInputExample
+  });
   const multilineExample = includeMultilineExample ? `
 
 For multiline values, use YAML's literal block syntax:
@@ -10161,7 +10251,7 @@ contents: |
   Second line
   Third line
 </write_file>` : "";
-  return `# Tools
+  const basePrompt = `# Tools
 
 You may call one or more functions to assist with the user query.
 
@@ -10187,6 +10277,26 @@ unit: celsius
 - After calling a tool, you will receive a response. Use this result to answer the user.
 - Do NOT ask clarifying questions. Use reasonable defaults for optional parameters.
 - If a task requires multiple function calls, make ALL of them at once.`;
+  if (inputExamplesText.length === 0) {
+    return basePrompt;
+  }
+  return `${basePrompt}
+
+${inputExamplesText}`;
+}
+function renderYamlXmlInputExample(toolName, input) {
+  const safeToolName = toSafeXmlTagName(toolName);
+  let yamlBody = "null";
+  try {
+    const yaml = import_yaml2.default.stringify(input).trimEnd();
+    yamlBody = yaml.length > 0 ? yaml : "null";
+  } catch (error) {
+    yamlBody = safeStringifyInputExample(input, error);
+  }
+  const escapedYamlBody = escapeXmlMinimalText(yamlBody);
+  return `<${safeToolName}>
+${escapedYamlBody}
+</${safeToolName}>`;
 }
 function formatToolResponseAsYaml(toolResult) {
   return morphFormatToolResponseAsXml(toolResult);
@@ -10796,12 +10906,23 @@ var yamlXmlToolMiddleware = createToolMiddleware({
 });
 
 // src/community/sijawara.ts
+function hasInvalidXmlKeys(value) {
+  if (Array.isArray(value)) {
+    return value.some((entry) => hasInvalidXmlKeys(entry));
+  }
+  if (value && typeof value === "object") {
+    return Object.entries(value).some(
+      ([key, nested]) => !isValidXmlTagName(key) || hasInvalidXmlKeys(nested)
+    );
+  }
+  return false;
+}
 var sijawaraDetailedXmlToolMiddleware = createToolMiddleware({
   protocol: morphXmlProtocol,
   toolResponsePromptTemplate: morphFormatToolResponseAsXml,
   toolSystemPromptTemplate(tools) {
     const toolsJson = JSON.stringify(tools);
-    return `You have access to callable functions (tools).
+    const basePrompt = `You have access to callable functions (tools).
     Tool list/context:
     ${toolsJson}
 
@@ -10852,6 +10973,13 @@ var sijawaraDetailedXmlToolMiddleware = createToolMiddleware({
     - Include all required parameters. If info is missing, ask the user.
     - Do NOT use JSON\u2014use only the specified XML-like format for tool calls.
     - If no call is needed, reply without a tool call.`;
+    const inputExamplesText = renderSijawaraInputExamples(tools);
+    if (inputExamplesText.length === 0) {
+      return basePrompt;
+    }
+    return `${basePrompt}
+
+${inputExamplesText}`;
   }
 });
 var sijawaraConciseXmlToolMiddleware = createToolMiddleware({
@@ -10859,7 +10987,7 @@ var sijawaraConciseXmlToolMiddleware = createToolMiddleware({
   toolResponsePromptTemplate: morphFormatToolResponseAsXml,
   toolSystemPromptTemplate(tools) {
     const toolsJson = JSON.stringify(tools);
-    return `You have access to callable functions (tools).
+    const basePrompt = `You have access to callable functions (tools).
     Tool list/context:
     ${toolsJson}
 
@@ -10885,8 +11013,40 @@ var sijawaraConciseXmlToolMiddleware = createToolMiddleware({
         San Francisco
       </location>
     </get_weather>`;
+    const inputExamplesText = renderSijawaraInputExamples(tools);
+    if (inputExamplesText.length === 0) {
+      return basePrompt;
+    }
+    return `${basePrompt}
+
+${inputExamplesText}`;
   }
 });
+function renderSijawaraInputExamples(tools) {
+  return renderInputExamplesSection({
+    tools,
+    renderExample: renderSijawaraInputExample
+  });
+}
+function renderSijawaraInputExample(toolName, input) {
+  const safeToolName = toSafeXmlTagName(toolName);
+  if (hasInvalidXmlKeys(input)) {
+    const fallbackContent = safeStringifyInputExample(input);
+    const escapedFallback = escapeXmlMinimalText(fallbackContent);
+    return `<${safeToolName}>${escapedFallback}</${safeToolName}>`;
+  }
+  try {
+    return stringify(safeToolName, input, {
+      suppressEmptyNode: false,
+      format: true,
+      minimalEscaping: true
+    });
+  } catch (error) {
+    const fallbackContent = safeStringifyInputExample(input, error);
+    const escapedFallback = escapeXmlMinimalText(fallbackContent);
+    return `<${safeToolName}>${escapedFallback}</${safeToolName}>`;
+  }
+}
 
 // src/community/ui-tars.ts
 var uiTarsToolMiddleware = createToolMiddleware({
@@ -10894,7 +11054,7 @@ var uiTarsToolMiddleware = createToolMiddleware({
   toolResponsePromptTemplate: morphFormatToolResponseAsXml,
   toolSystemPromptTemplate(tools) {
     const toolsJson = JSON.stringify(tools);
-    return `You have access to callable functions (tools).
+    const basePrompt = `You have access to callable functions (tools).
 Tool list/context:
 ${toolsJson}
 
@@ -11000,8 +11160,57 @@ EXECUTION RULES
 - If you don't know a parameter value, ask the user
 - After calling a function, STOP and wait for the result
 - Do NOT add extra text before or after tool calls`;
+    const inputExamplesText = renderUiTarsInputExamples(tools);
+    if (inputExamplesText.length === 0) {
+      return basePrompt;
+    }
+    return `${basePrompt}
+
+${inputExamplesText}`;
   }
 });
+function renderUiTarsInputExamples(tools) {
+  return renderInputExamplesSection({
+    tools,
+    renderExample: renderUiTarsInputExample
+  });
+}
+function renderUiTarsInputExample(toolName, input) {
+  const parameterBlocks = renderUiTarsParameters(input);
+  return `<tool_call>
+<function=${escapeXmlMinimalAttr(toolName, '"')}>${parameterBlocks}
+</function>
+</tool_call>`;
+}
+function renderUiTarsParameters(input) {
+  if (isRecord3(input)) {
+    const lines = Object.entries(input).map(([key, value]) => {
+      const content = renderUiTarsParameterValue(value);
+      return `<parameter=${escapeXmlMinimalAttr(key, '"')}>
+${content}
+</parameter>`;
+    });
+    if (lines.length > 0) {
+      return `
+${lines.join("\n")}`;
+    }
+  }
+  const fallback = renderUiTarsParameterValue(input);
+  return `
+<parameter=input>
+${fallback}
+</parameter>`;
+}
+function renderUiTarsParameterValue(value) {
+  if (typeof value === "string") {
+    return escapeXmlMinimalText(value);
+  }
+  const serialized = safeStringifyInputExample(value);
+  return escapeXmlMinimalText(serialized);
+}
+function isRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   sijawaraConciseXmlToolMiddleware,