/**
 * Agent response and session state types
 */
import type { Status, RuleMatchMethod } from './status.js';
import type { AgentFailureCategory } from '../../shared/types/agent-failure.js';
import type { ProviderType } from '../../shared/types/provider.js';
export type AgentErrorKind = 'rate_limit';
export declare const RATE_LIMIT_ERROR_MESSAGE = "Rate limit exceeded. Please try again later.";
export declare function resolveAgentErrorMessage(errorKind: AgentErrorKind | undefined, fallbackMessage: string): string;
export declare function sumRetryCounts(responses: readonly Pick<AgentResponse, 'retryCount'>[]): number | undefined;
export interface ProviderUsageSnapshot {
    inputTokens?: number;
    outputTokens?: number;
    totalTokens?: number;
    cachedInputTokens?: number;
    cacheCreationInputTokens?: number;
    cacheReadInputTokens?: number;
    usageMissing: boolean;
    reason?: string;
}
export interface RateLimitInfo {
    provider: ProviderType;
    detectedAt: Date;
    resetAtRaw?: string;
    source: 'sdk_error' | 'stream_marker' | 'error_text';
}
/** Response from an agent execution */
export interface AgentResponse {
    persona: string;
    status: Status;
    content: string;
    timestamp: Date;
    sessionId?: string;
    /** Error message when the query failed (e.g., API error, rate limit) */
    error?: string;
    /** Machine-readable error classification normalized at the provider boundary */
    errorKind?: AgentErrorKind;
    /** Rate limit metadata normalized at the provider boundary */
    rateLimitInfo?: RateLimitInfo;
    /** Machine-readable failure classification normalized at the provider boundary */
    failureCategory?: AgentFailureCategory;
    /** Matched rule index (0-based) when rules-based detection was used */
    matchedRuleIndex?: number;
    /** How the rule match was detected */
    matchedRuleMethod?: RuleMatchMethod;
    /** Structured output returned by provider SDK (JSON Schema mode) */
    structuredOutput?: Record<string, unknown>;
    /** Provider-native usage payload normalized for TAKT observability */
    providerUsage?: ProviderUsageSnapshot;
    /** Number of provider-level retry attempts performed before this response */
    retryCount?: number;
    /**
     * Provider 内部のデバッグスナップショット（例: OpenCode の tool health
     * メトリクス）。閾値校正・調査用の観測データであり、制御フローには使わない。
     */
    debugInfo?: Record<string, unknown>;
}
//# sourceMappingURL=response.d.ts.map