read-item.tool.ts•1.58 kB
import { readQuickbooksItem } from "../handlers/read-quickbooks-item.handler.js";
import { ToolDefinition } from "../types/tool-definition.js";
import { z } from "zod";
const toolName = "read_item";
const toolTitle = "Read Item";
const toolDescription = "Read a single item in QuickBooks Online by its ID.";
const inputSchema = {
item_id: z.string().min(1, { message: "Item ID is required" }),
};
const outputSchema = {
success: z.boolean().describe("Whether the operation was successful"),
data: z.any().optional().describe("The result data"),
error: z.string().optional().describe("Error message if operation failed"),
};
const toolHandler = async (params: z.infer<z.ZodObject<typeof inputSchema>>) => {
const { item_id } = params;
const response = await readQuickbooksItem(item_id);
if (response.isError) {
const output = {
success: false,
error: response.error || "Unknown error occurred",
};
return {
content: [
{
type: "text" as const,
text: JSON.stringify(output, null, 2),
},
],
structuredContent: output,
isError: true,
};
}
return {
content: [
{ type: "text" as const, text: `Item details for ID ${item_id}:` },
{ type: "text" as const, text: JSON.stringify(response.result, null, 2) },
],
};
};
export const ReadItemTool: ToolDefinition<typeof inputSchema, typeof outputSchema> = {
name: toolName,
title: toolTitle,
description: toolDescription,
inputSchema: inputSchema,
outputSchema: outputSchema,
handler: toolHandler,
};