{
  name: string,                    // Tool identifier
  description: string,             // Human-readable description
  inputSchema: object,             // JSON schema of input parameters
  outputSchema: object,            // JSON schema of output result
  configSchema?: object,           // JSON schema of configuration parameters
  defaultConfig?: object,          // Default configuration values
}

import { tools, invoke } from 'aws-tools';

// Get tool metadata
const toolMetadata = tools.find(tool => tool.name === 'awsDescribeInstances');

// Invoke a tool
const result = await invoke('awsDescribeInstances', {}, {
  credentials: {
    accessKeyId: 'YOUR_ACCESS_KEY',
    secretAccessKey: 'YOUR_SECRET_KEY'
  },
  region: 'us-east-1'
});

// Result format
console.log(result.summary);     // Human-readable summary
console.log(result.datapoints);  // Raw data for charting

{
  credentials: {
    accessKeyId: string,
    secretAccessKey: string,
    sessionToken?: string
  },
  region: string,                    // AWS region (e.g., "us-east-1")
  logger?: {
    log: (message: string) => void,
    error: (message: string) => void,
    warn: (message: string) => void
  }
}

{
  region: string                    // Required: AWS region (e.g., "us-east-1")
  instanceIds?: string[]           // Optional: Specific instance IDs to describe
  filters?: Array<{                // Optional: AWS EC2 filters
    name: string
    values: string[]
  }>
  maxResults?: number              // Optional: Maximum results (default: 1000)
}

{
  summary: string                  // Text summary of EC2 instances with cost information
  datapoints: Array<{
    instanceId: string             // EC2 instance ID
    instanceName: string           // Instance name from Name tag
    instanceType: string           // Instance type (e.g., "m5.large")
    platform: string               // Platform details
    tenancy: string                // Tenancy type
    region: string                 // AWS region
    uptimeHours: number            // Instance uptime in hours
    state: string                  // Instance state
    tags: object                   // Instance tags (excluding Name tag)
    cost?: {                       // Optional: Cost information
      onDemandCost: {              // OnDemand pricing
        hourlyCost: number         // Hourly OnDemand cost in USD
        monthlyCost: number        // Monthly OnDemand cost in USD (730 hours)
      }
      savingsPlanCost: {           // 3-year no-upfront Compute Savings Plan pricing
        hourlyCost: number         // Hourly Savings Plan cost in USD
        monthlyCost: number        // Monthly Savings Plan cost in USD (730 hours)
      }
      specifications?: {           // Instance specifications from pricing data
        vCPU: number               // Number of virtual CPUs
        memory: number             // Memory in GiB
        networkPerformance: number // Network performance in Mbps
        dedicatedEbsThroughput: number // Dedicated EBS throughput in Mbps
        gpu?: number               // Number of GPUs (if applicable)
        gpuMemory?: number         // GPU memory in GB (if applicable)
      }
      pricingDetails?: {           // Detailed pricing information
        family: string             // Instance family (e.g., "m5")
        size: string               // Instance size (e.g., "large")
        operationCode: string      // OS/software operation code
        tenancyType: string        // "Shared" or "Dedicated"
        currentGeneration: boolean // Whether it's current generation
        instanceFamily: string     // Instance family category
        physicalProcessor: string  // CPU manufacturer and model
        clockSpeed: number         // Processor clock speed in GHz
        processorFeatures: string  // CPU features (e.g., "AVX, AVX2")
      }
    }
    volumes: Array<{               // Attached EBS volumes
      volumeId: string             // Volume ID
      size: number                 // Volume size in GB
      volumeType: string           // Volume type (e.g., "gp2", "io1")
      iops?: number                // IOPS (for io1 volumes)
      encrypted: boolean           // Whether volume is encrypted
    }>
  }>
}

// Get all instances in us-east-1
{
  region: "us-east-1"
}

// Get specific instances with filters
{
  region: "us-west-2",
  instanceIds: ["i-1234567890abcdef0"],
  filters: [
    {
      name: "instance-state-name",
      values: ["running"]
    }
  ]
}

{
  lookBack?: number                // Optional: Number of days (DAILY) or months (MONTHLY) to look back. Default: 30 for DAILY, 6 for MONTHLY
  granularity: "DAILY" | "MONTHLY" // Required: Data granularity
  groupBy?: string[]               // Optional: Grouping dimensions (max 2)
  filter?: object                  // Optional: Cost Explorer filters
}

{
  summary: string                  // Human-readable summary
  datapoints: Array<{
    date: string                   // Date of the cost data
    dimensions: {                  // Grouping dimensions and values
      [key: string]: string
    }
    amortizedCost: number          // Amortized cost amount
    usageAmount: number            // Usage quantity
  }>
}

// Get daily costs for the last 10 days
{
  lookBack: 10,
  granularity: "DAILY"
}

// Get monthly costs for the last 6 months, grouped by service and region
{
  lookBack: 6,
  granularity: "MONTHLY",
  groupBy: ["SERVICE", "REGION"]
}