@ai-sdk-tool/parser 4.1.1 → 4.1.3

package/dist/{chunk-722D5BGD.js → chunk-ZIOUCBCX.js}

@@ -5802,6 +5802,65 @@ async function wrapGenerate({
   };
 }
 
+// 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) {
@@ -6042,11 +6101,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>`;
 }
 
@@ -6054,6 +6130,7 @@ For each function call return a json object with function name and arguments wit
 import dedent from "dedent";
 function morphXmlSystemPromptTemplate(tools) {
   const toolsText = renderToolsForXmlPrompt(tools);
+  const inputExamplesText = renderInputExamplesForXmlPrompt(tools);
   const header = dedent`
     # Tools
     You may call one or more functions to assist with the user query.
@@ -6068,7 +6145,7 @@ function morphXmlSystemPromptTemplate(tools) {
     <rules>
     - Use exactly one XML element whose tag name is the function name.
     - Put each parameter as a child element.
-    - Values must follow the schema exactly (numbers, arrays, objects, enums → copy as-is).
+    - Values must follow the schema exactly (numbers, arrays, objects, enums -> copy as-is).
     - Do not add or remove functions or parameters.
     - Each required parameter must appear once.
     - Output nothing before or after the function call.
@@ -6084,7 +6161,7 @@ function morphXmlSystemPromptTemplate(tools) {
     multiple lines</example_parameter_2>
     </example_function_name>
   `;
-  return [header, definitions, rules, examples].join("\n\n");
+  return [header, definitions, rules, examples, inputExamplesText].filter((section) => section.trim().length > 0).join("\n\n");
 }
 var INDENT = "  ";
 function renderToolsForXmlPrompt(tools) {
@@ -6104,6 +6181,25 @@ function renderToolForXmlPrompt(tool) {
   lines.push(`schema: ${stringifySchema(normalizedSchema)}`);
   return lines.join("\n");
 }
+function renderMorphXmlInputExample(toolName, input) {
+  try {
+    return stringify(toolName, input, {
+      suppressEmptyNode: false,
+      format: true,
+      minimalEscaping: true
+    });
+  } catch (error) {
+    const fallbackContent = safeStringifyInputExample(input, error);
+    const escapedFallback = escapeXmlMinimalText(fallbackContent);
+    return `<${toolName}>${escapedFallback}</${toolName}>`;
+  }
+}
+function renderInputExamplesForXmlPrompt(tools) {
+  return renderInputExamplesSection({
+    tools,
+    renderExample: renderMorphXmlInputExample
+  });
+}
 function normalizeSchema(schema) {
   if (typeof schema === "string") {
     try {
@@ -6448,8 +6544,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;
@@ -6470,9 +6608,25 @@ function formatToolResponseAsQwen3CoderXml(toolResult) {
   return formatToolResponseAsQwen3CoderXmlWithOptions(toolResult);
 }
 
+// src/core/prompts/yaml-xml-prompt.ts
+import YAML2 from "yaml";
+
+// 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/core/prompts/yaml-xml-prompt.ts
 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:
@@ -6483,7 +6637,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.
 
@@ -6509,6 +6663,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 = YAML2.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);
@@ -7145,7 +7319,11 @@ export {
   isToolResultPart,
   hasInputProperty,
   wrapGenerate,
+  safeStringifyInputExample,
+  renderInputExamplesSection,
   morphFormatToolResponseAsXml,
+  isValidXmlTagName,
+  toSafeXmlTagName,
   wrapStream,
   toolChoiceStream,
   transformParams,
@@ -7155,4 +7333,4 @@ export {
   morphXmlToolMiddleware,
   yamlXmlToolMiddleware
 };
-//# sourceMappingURL=chunk-722D5BGD.js.map
+//# sourceMappingURL=chunk-ZIOUCBCX.js.map