Function getShortToolInstructions

packages/agent-runtime/src/tools/prompts.ts:295–347

(
  toolNames: readonly string[],
  additionalToolDefinitions: CustomToolDefinitions,
)

}

export const getShortToolInstructions = (
  toolNames: readonly string[],
  additionalToolDefinitions: CustomToolDefinitions,
) => {
  if (
    toolNames.length === 0 &&
    Object.keys(additionalToolDefinitions).length === 0
  ) {
    return ''
  }

  const toolDescriptionsList = [
    ...(
      toolNames.filter(
        (name) => (name as keyof typeof toolParams) in toolParams,
      ) as (keyof typeof toolParams)[]
    ).map((name) => {
      const tool = toolParams[name]
      return buildShortToolDescription({
        toolName: name,
        schema: tool.inputSchema,
        endsAgentStep: tool.endsAgentStep,
      })
    }),
    ...Object.keys(additionalToolDefinitions).map((name) => {
      const { inputSchema, endsAgentStep } = additionalToolDefinitions[name]
      return buildShortToolDescription({
        toolName: name,
        schema: ensureZodSchema(inputSchema),
        endsAgentStep: endsAgentStep ?? true,
      })
    }),
  ]

  return `## Tools
Use the tools below to complete the user request, if applicable.

Tool calls use a specific XML and JSON-like format. Adhere *precisely* to this nested element structure:

${getToolCallString(
    'tool_name',
    {
      parameter1: 'value1',
      parameter2: 123,
    },
    false,
  )}

Important: You only have access to the tools below. Do not use any other tools -- they are not available to you, instead they may have been previously used by other agents.

${toolDescriptionsList.join('\n\n')}
`.trim()
}

export async function getToolSet(params: {
  toolNames: string[]