Providers

interface Provider {
  name: string;           // Unique identifier
  description?: string;   // What it provides
  dynamic?: boolean;      // Changes over time?
  position?: number;      // Load priority (-100 to 100)
  private?: boolean;      // Hidden from provider list?
  get: (runtime, message, state) => Promise<ProviderResult>;
}

const provider: Provider = {
  name: 'MY_DATA',
  get: async (runtime, message, state) => {
    return {
      text: "Contextual information",
      data: { key: "value" }
    };
  }
};

const dynamicProvider: Provider = {
  name: 'LIVE_DATA',
  dynamic: true,  // Re-fetched each time
  get: async (runtime) => {
    const data = await fetchLatestData();
    return { data };
  }
};

const secretProvider: Provider = {
  name: 'INTERNAL_STATE',
  private: true,  // Not shown in provider list
  get: async (runtime) => {
    return runtime.getInternalState();
  }
};

interface ProviderResult {
  text?: string;      // Natural language context
  data?: {           // Structured data
    [key: string]: any;
  };
  values?: {         // Key-value pairs
    [key: string]: any;
  };
}

// Lower numbers = higher priority
position: -100  // Loads first
position: 0     // Default
position: 100   // Loads last