sim/tools/types.ts

export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';

export interface ToolResponse {
  output: any;  // All tools must provide an output field
  [key: string]: any;  // Tools can include additional metadata
}

export interface ToolConfig<P = any, R extends ToolResponse = ToolResponse> {
  // Basic tool identification
  id: string;
  name: string;
  description: string;
  version: string;

  // Parameter schema - what this tool accepts
  params: Record<string, {
    type: string;
    required?: boolean;
    default?: any;
    description?: string;
  }>;

  // Request configuration
  request: {
    url: string | ((params: P) => string);
    method: string;
    headers: (params: P) => Record<string, string>;
    body?: (params: P) => Record<string, any>;
  };

  // Response handling
  transformResponse: (response: Response) => Promise<R>;
  transformError: (error: any) => string;
}