Tool Use & Function Calling

// 1. Define the tool schema
const tools = [{
  name: "read_file",
  description: "Read the contents of a file",
  parameters: {
    type: "object",
    properties: {
      path: {
        type: "string",
        description: "The file path to read"
      }
    },
    required: ["path"]
  }
}];

// 2. Send to LLM with tools available
const response = await claude.chat({
  messages: [{ role: "user", content: "What's in package.json?" }],
  tools: tools
});

// 3. LLM responds with a tool call
// response.tool_calls = [{
//   name: "read_file",
//   arguments: { path: "package.json" }
// }]

// 4. Execute the tool
const fileContents = await readFile("package.json");

// 5. Send result back to LLM
const finalResponse = await claude.chat({
  messages: [
    ...previousMessages,
    { role: "tool", content: fileContents }
  ]
});

// 6. LLM provides final answer based on tool result

// Read Tool
{
  name: "Read",
  description: "Reads a file from the filesystem",
  parameters: {
    file_path: "string (required) - absolute path",
    offset: "number (optional) - line to start from",
    limit: "number (optional) - max lines to read"
  }
}

// Edit Tool
{
  name: "Edit",
  description: "Makes targeted edits to a file",
  parameters: {
    file_path: "string (required) - file to edit",
    old_string: "string (required) - text to replace",
    new_string: "string (required) - replacement text"
  }
}

// Bash Tool
{
  name: "Bash",
  description: "Executes shell commands",
  parameters: {
    command: "string (required) - command to run",
    timeout: "number (optional) - max execution time"
  }
}