Function buildCompactToolPreambleForProto

src/handlers/tool-emulation.js:582–617

(tools, toolChoice, environment, modelKey = null, provider = null, route = null)

 * retries until the proxy gives up.
 */
export function buildCompactToolPreambleForProto(tools, toolChoice, environment, modelKey = null, provider = null, route = null) {
  if (!Array.isArray(tools) || tools.length === 0) return '';
  const { mode, forceName } = resolveToolChoice(toolChoice);
  const dialect = pickToolDialect(modelKey, provider, route);
  const protocol = protocolHeaderForTools(dialect, mode, forceName, true);
  const names = [];
  for (const t of tools) {
    if (t?.type !== 'function' || !t.function?.name) continue;
    names.push(t.function.name);
  }
  if (!names.length) return '';

  const lines = [];
  if (environment && typeof environment === 'string' && environment.trim()) {
    lines.push('## Environment facts');
    lines.push('The facts below are provided by the calling agent and describe the active execution context. Tool calls operate on these paths.');
    lines.push('');
    lines.push(environment.trim());
    lines.push('');
    lines.push(WORKSPACE_STUB_OVERRIDE);
    lines.push('');
  }
  lines.push(WORKSPACE_PATH_HINT);
  lines.push('');
  lines.push(protocol);
  const specificRules = toolSpecificRules(tools);
  if (specificRules.length) {
    lines.push('');
    lines.push('Tool argument fidelity rules:');
    lines.push(...specificRules);
  }
  lines.push('');
  lines.push(`Available functions: ${names.join(', ')}.`);
  lines.push('Parameter schemas are omitted in this preamble due to total tool-list size. Match each <tool_call> to the function name; the calling agent will validate argument shapes when it executes the call.');
  return lines.join('\n');
}

function safeParseJson(s) {
  if (typeof s !== 'string') return null;