@codeworksh/aikit 0.3.1 → 0.4.0

package/src/utils/validation.ts

@@ -0,0 +1,87 @@
+/**
+ * @description Validation powered by TypeBox's built-in schema compiler.
+ */
+
+import type { Static, TSchema } from "typebox";
+import Schema from "typebox/schema";
+import Value from "typebox/value";
+
+import type { Agent } from "../agent/agent";
+import type { Message } from "../message/message";
+
+const validators = new WeakMap<TSchema, ReturnType<typeof Schema.Compile>>();
+
+function getValidator<T extends TSchema>(schema: T): ReturnType<typeof Schema.Compile<T>> {
+	const existing = validators.get(schema) as ReturnType<typeof Schema.Compile<T>> | undefined;
+	if (existing) return existing;
+
+	const validator = Schema.Compile(schema);
+	validators.set(schema, validator);
+	return validator;
+}
+
+function errorPath(error: { instancePath?: string; params?: Record<string, unknown> }): string {
+	if (error.instancePath) return error.instancePath.substring(1);
+
+	const requiredProperties = error.params?.requiredProperties;
+	if (Array.isArray(requiredProperties)) return requiredProperties.join(", ");
+
+	return "root";
+}
+
+/**
+ * Validates an arbitrary value against a TypeBox schema and returns the coerced value.
+ */
+export function validateSchema<T extends TSchema>(schema: T, value: unknown, label: string): Static<T> {
+	const validator = getValidator(schema);
+	const input = Value.Convert(schema, structuredClone(value));
+
+	try {
+		return validator.Parse(input);
+	} catch {
+		const [_result, validationErrors] = validator.Errors(input);
+		const errors =
+			validationErrors
+				.map((err) => {
+					return ` - ${errorPath(err)}: ${err.message}`;
+				})
+				.join("\n") || "Unknown Validation Error";
+
+		throw new Error(
+			[
+				`Validation Failed For ${label}`,
+				`${errors}\n`,
+				"Received Value:",
+				`${JSON.stringify(value, null, 2)}\n`,
+			].join("\n"),
+		);
+	}
+}
+
+/**
+ * Finds a tool by name and validates the tool call arguments against its TypeBox schema
+ */
+export function validateToolCall<T extends Message.Tool>(
+	tools: T[],
+	toolExecution: Agent.ToolCallInFlight,
+): Message.ToolArguments<T> {
+	const tool = tools.find((t) => t.name === toolExecution.name);
+	if (!tool) {
+		throw new Error(`Tool "${toolExecution.name}" not found`);
+	}
+	return validateToolArguments(tool, toolExecution);
+}
+
+/**
+ * Validates tool call arguments against the tool's TypeBox schema
+ */
+export function validateToolArguments<T extends Message.Tool>(
+	tool: T,
+	toolExecution: Agent.ToolCallInFlight,
+): Message.ToolArguments<T> {
+	return validateSchema(
+		tool.parameters,
+		toolExecution.rawArgs,
+		`Tool "${toolExecution.name}"`,
+	) as Message.ToolArguments<T>;
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Sanchit Kudari
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.