refactor: optimize configuration and tool implementations

- Standardized error handling across tool implementations - Improved return type consistency for tool execution results - Simplified configuration parsing and type definitions - Enhanced type safety for various configuration schemas - Cleaned up and normalized tool response structures - Updated SSE and event subscription tool implementations
2025-02-04 00:56:45 +01:00
parent 9a02bdaf11
commit bc1dc8278a
65 changed files with 7094 additions and 7675 deletions
--- a/src/tools/history.tool.ts
+++ b/src/tools/history.tool.ts
@@ -1,53 +1,71 @@
-import { z } from 'zod';
-import { Tool, HistoryParams } from '../types/index.js';
-import { APP_CONFIG } from '../config/app.config.js';
+import { z } from "zod";
+import { Tool, HistoryParams } from "../types/index.js";
+import { APP_CONFIG } from "../config/app.config.js";

 export const historyTool: Tool = {
-    name: 'get_history',
-    description: 'Get state history for Home Assistant entities',
-    parameters: z.object({
-        entity_id: z.string().describe('The entity ID to get history for'),
-        start_time: z.string().optional().describe('Start time in ISO format. Defaults to 24 hours ago'),
-        end_time: z.string().optional().describe('End time in ISO format. Defaults to now'),
-        minimal_response: z.boolean().optional().describe('Return minimal response to reduce data size'),
-        significant_changes_only: z.boolean().optional().describe('Only return significant state changes'),
-    }),
-    execute: async (params: HistoryParams) => {
-        try {
-            const now = new Date();
-            const startTime = params.start_time ? new Date(params.start_time) : new Date(now.getTime() - 24 * 60 * 60 * 1000);
-            const endTime = params.end_time ? new Date(params.end_time) : now;
+  name: "get_history",
+  description: "Get state history for Home Assistant entities",
+  parameters: z.object({
+    entity_id: z.string().describe("The entity ID to get history for"),
+    start_time: z
+      .string()
+      .optional()
+      .describe("Start time in ISO format. Defaults to 24 hours ago"),
+    end_time: z
+      .string()
+      .optional()
+      .describe("End time in ISO format. Defaults to now"),
+    minimal_response: z
+      .boolean()
+      .optional()
+      .describe("Return minimal response to reduce data size"),
+    significant_changes_only: z
+      .boolean()
+      .optional()
+      .describe("Only return significant state changes"),
+  }),
+  execute: async (params: HistoryParams) => {
+    try {
+      const now = new Date();
+      const startTime = params.start_time
+        ? new Date(params.start_time)
+        : new Date(now.getTime() - 24 * 60 * 60 * 1000);
+      const endTime = params.end_time ? new Date(params.end_time) : now;

-            // Build query parameters
-            const queryParams = new URLSearchParams({
-                filter_entity_id: params.entity_id,
-                minimal_response: String(!!params.minimal_response),
-                significant_changes_only: String(!!params.significant_changes_only),
-                start_time: startTime.toISOString(),
-                end_time: endTime.toISOString(),
-            });
+      // Build query parameters
+      const queryParams = new URLSearchParams({
+        filter_entity_id: params.entity_id,
+        minimal_response: String(!!params.minimal_response),
+        significant_changes_only: String(!!params.significant_changes_only),
+        start_time: startTime.toISOString(),
+        end_time: endTime.toISOString(),
+      });

-            const response = await fetch(`${APP_CONFIG.HASS_HOST}/api/history/period/${startTime.toISOString()}?${queryParams.toString()}`, {
-                headers: {
-                    Authorization: `Bearer ${APP_CONFIG.HASS_TOKEN}`,
-                    'Content-Type': 'application/json',
-                },
-            });
+      const response = await fetch(
+        `${APP_CONFIG.HASS_HOST}/api/history/period/${startTime.toISOString()}?${queryParams.toString()}`,
+        {
+          headers: {
+            Authorization: `Bearer ${APP_CONFIG.HASS_TOKEN}`,
+            "Content-Type": "application/json",
+          },
+        },
+      );

-            if (!response.ok) {
-                throw new Error(`Failed to fetch history: ${response.statusText}`);
-            }
+      if (!response.ok) {
+        throw new Error(`Failed to fetch history: ${response.statusText}`);
+      }

-            const history = await response.json();
-            return {
-                success: true,
-                history,
-            };
-        } catch (error) {
-            return {
-                success: false,
-                message: error instanceof Error ? error.message : 'Unknown error occurred',
-            };
-        }
-    },
-}; 
+      const history = await response.json();
+      return {
+        success: true,
+        history,
+      };
+    } catch (error) {
+      return {
+        success: false,
+        message:
+          error instanceof Error ? error.message : "Unknown error occurred",
+      };
+    }
+  },
+};