Skip to main content

getKarmaHistory

codebolt.agentPortfolio.getKarmaHistory(agentId: string, limit: number): Promise<GetKarmaHistoryResponse>

Retrieves the karma history of an agent, showing all karma changes over time.

Parameters​

  • agentId (string): The ID of the agent.
  • limit (number, optional): Maximum number of entries to return.

Returns​

  • Promise<[GetKarmaHistoryResponse](/docs/reference/type-reference/codeboltjs/interfaces/GetKarmaHistoryResponse)>: A promise that resolves to the karma history.

Examples​

const history = await codebolt.agentPortfolio.getKarmaHistory('agent-123', 50);
history.data?.changes.forEach(change => {
  console.log(`${change.amount}: ${change.reason} (${change.createdAt})`);
});

Notes​

  • Shows chronological history of karma changes
  • Useful for tracking reputation trends
  • Both positive and negative changes are shown