import { Router } from 'express';
import type { ContextTier } from '../prime.js';
/**
 * Context usage information from check-context.sh
 */
export interface ContextInfo {
    percent: number | null;
    tokens: number | null;
    status: string | null;
    error: string | null;
    sessionId?: string;
    /** System prompt overhead (first turn tokens) */
    baseline: number | null;
    /** Tokens used by conversation (total - baseline) */
    usableTokens: number | null;
    /** Conversation usage as % of available capacity */
    usablePercent: number | null;
    /** Available capacity (max - baseline) */
    available: number | null;
    /** Current context tier (FULL, REFRESH, HANDOFF, MINIMAL) */
    tier?: ContextTier;
    /** Per-component token counts (MSSCI-12800) */
    tokenCounts?: Record<string, number>;
    /** Total tokens across all injected components (MSSCI-12800) */
    totalTokens?: number;
}
/**
 * Get context usage by running check-context.sh
 * @param projectDir - The project directory
 * @param sessionId - Optional session ID to check specific transcript
 * @returns Context usage info
 */
export declare function getContextUsage(projectDir: string, sessionId?: string): ContextInfo;
/**
 * Create context API router
 */
export declare function createContextRouter(getProjectDir: () => string): Router;
//# sourceMappingURL=context.d.ts.map