Class AgentContext

Execution context for an AI agent, managing conversation history, cost tracking, and budgets.

Example

const context = new AgentContext({
  userId: 'user-123',
  sessionId: 'session-abc',
  environment: 'production',
  metadata: { department: 'support' }
});

context.setBudget(1.00); // $1 max
context.addMessage({ role: 'user', content: 'Hello', timestamp: new Date() });
context.recordCost({ provider: 'openai', model: 'gpt-4', inputTokens: 100, outputTokens: 50, cost: 0.05 });

Constructors

constructor

Methods

addMessage getMessages getRecentMessages recordCost getTotalCost getCosts setBudget getRemainingBudget isBudgetExceeded getDuration

Properties

userId? sessionId timestamp environment metadata

Constructors

constructor

  • new AgentContext(
        options: {
            userId?: string;
            sessionId: string;
            environment: "development" | "staging" | "production";
            metadata?: Record<string, unknown>;
        },
    ): AgentContext

    Parameters

    • options: {
          userId?: string;
          sessionId: string;
          environment: "development" | "staging" | "production";
          metadata?: Record<string, unknown>;
      }

    Returns AgentContext

Methods

addMessage

getMessages

getRecentMessages

recordCost

getTotalCost

getCosts

setBudget

getRemainingBudget

  • getRemainingBudget(): undefined | number

    Gets the remaining budget

    Returns undefined | number

    The remaining budget, or undefined if no budget was set

isBudgetExceeded

getDuration

Properties

Optional ReadonlyuserId

userId?: string

ReadonlysessionId

sessionId: string

Readonlytimestamp

timestamp: Date

Readonlyenvironment

environment: "development" | "staging" | "production"

Readonlymetadata

metadata: Record<string, unknown>

Settings

Member Visibility

On This Page

Constructors
Methods
Properties