Function fullToolList

packages/agent-runtime/src/tools/prompts.ts:243–293

(
  toolNames: readonly string[],
  additionalToolDefinitions: CustomToolDefinitions,
  options?: { availableSkillsXml?: string },
)

}

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

  const { availableSkillsXml = '' } = options ?? {}

  // Build tool descriptions, replacing skill placeholder with actual skills
  const descriptions = [
    ...(
      toolNames.filter((toolName) =>
        toolNames.includes(toolName as ToolName),
      ) as ToolName[]
    ).map((name) => {
      let desc = toolDescriptions[name]
      // Replace skill placeholder with actual available skills
      if (name === 'skill' && availableSkillsXml) {
        desc = desc.replace(AVAILABLE_SKILLS_PLACEHOLDER, availableSkillsXml)
      } else if (name === 'skill') {
        // Explicitly state no skills are available
        desc = desc.replace(
          AVAILABLE_SKILLS_PLACEHOLDER,
          'There are no skills available. Do not use this tool because there are no skills to load.',
        )
      }
      return desc
    }),
    ...Object.keys(additionalToolDefinitions).map((toolName) => {
      const toolDef = additionalToolDefinitions[toolName]
      return buildToolDescription({
        toolName,
        schema: ensureZodSchema(toolDef.inputSchema),
        description: toolDef.description,
        endsAgentStep: toolDef.endsAgentStep ?? true,
        exampleInputs: toolDef.exampleInputs,
      })
    }),]

  return `## List of Tools

These are the only tools that you can use. The user cannot see these descriptions, so you should not reference any tool names, parameters, or descriptions. Do not try to use any other tools -- even if referenced earlier in the conversation, they are not available to you, instead they may have been previously used by other agents.

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

export const getShortToolInstructions = (
  toolNames: readonly string[],