feat(tool): preserve root schema keywords in toJsonSchema pass-through

Author: willleeney

src/tool.ts

@@ -183,11 +183,17 @@ export class BaseTool {
 	 * This is framework-agnostic and can be used with any LLM that accepts JSON Schema
 	 */
 	toJsonSchema(): ObjectJSONSchema {
-		return {
+		const schema: Record<string, unknown> = {
+			...this.parameters,
 			type: 'object',
 			properties: this.parameters.properties,
-			required: this.parameters.required,
 		};
+		if (this.parameters.required && this.parameters.required.length > 0) {
+			schema.required = this.parameters.required;
+		} else {
+			delete schema.required;
+		}
+		return schema as unknown as ObjectJSONSchema;
 	}
 
 	/**

src/types.ts

@@ -159,7 +159,7 @@ export interface ToolExecution {
 /**
  * Schema definition for tool parameters
  */
-export interface ToolParameters {
+export interface ToolParameters extends Record<string, unknown> {
 	type: string;
 	properties: JsonSchemaProperties; // these are the params we will expose to the user/agent in the tool. These might be higher level params.
 	required?: string[]; // list of required parameter names