/** * Ledger context provider for comprehensive agent activity tracking. * * Tracks tool call history with inputs, outputs, timing, and success/failure status. * This audit trail enables steering handlers to make informed guidance decisions * based on agent behavior patterns and history. */ import type { LocalAgent } from '../../../types/agent.js'; import type { SteeringContextData, SteeringContextProvider } from './context-provider.js'; /** * Configuration for {@link ToolLedgerProvider}. */ export interface ToolLedgerProviderConfig { /** Maximum number of tool calls to retain. Older entries are dropped. Defaults to 100. */ maxEntries?: number; /** Identifier for this provider instance. Defaults to `'strands:steering:toolLedger'`. */ name?: string; } /** * Context provider that tracks tool call history within a single invocation. * * Records every tool invocation with inputs, execution time, and success/failure status. * The ledger is available to steering handlers for pattern detection * (e.g., repeated failures, excessive retries). * * When the ledger exceeds maxEntries, the oldest entries are dropped. * * @example * ```typescript * const handler = new LLMSteeringHandler({ * systemPrompt: '...', * contextProviders: [new ToolLedgerProvider()], * }) * ``` */ export declare class ToolLedgerProvider implements SteeringContextProvider { readonly name: string; private readonly _maxEntries; private readonly _toolCalls; constructor(config?: ToolLedgerProviderConfig); observeAgent(agent: LocalAgent): void; private _onBeforeToolCall; private _onAfterToolCall; /** * Return the current ledger snapshot. */ get context(): SteeringContextData; } //# sourceMappingURL=tool-ledger.d.ts.map