import type { MonoAgentConfig } from "@mono-agent/config";
import type { TraceSourceHandle, TraceSourceMemoryHealth } from "@mono-agent/observability";
import type { SandboxEngine } from "@mono-agent/runtime-adapter";
import type { AppTraceDefaults, ResolvedExporter } from "./app-config.js";
import type { ConfiguredAgentSessionEvent } from "./configured-agent.js";
import type { MemoryRetrievalService } from "./memory-retrieval.js";
import type { ExporterStatus, SandboxStatus, SessionTraceMetadata, TraceabilityStatus } from "./app-controller-types.js";
import type { BackgroundSnapshot } from "./background-snapshot.js";
import type { ChannelDriver, ChannelId, ChannelStatus, MonoAgentAppLogger } from "./channels.js";
import type { ProcessJobsServiceHandle } from "./process-jobs-service.js";
import { type ProcessJobsProtectionPosture } from "./process-jobs-protection.js";
export interface TraceabilityControllerPort {
    readonly env: Record<string, string | undefined>;
    readonly cwd: string;
    readonly configPath: string;
    readonly configReadPath: string;
    readonly logger: MonoAgentAppLogger | undefined;
    readonly traceDefaults: AppTraceDefaults | undefined;
    readonly backgroundSnapshot: BackgroundSnapshot | undefined;
    readonly drivers: readonly ChannelDriver[];
    readonly statuses: Map<ChannelId, ChannelStatus>;
    readonly processJobsService: ProcessJobsServiceHandle | undefined;
    readonly processJobsDegradation: {
        readonly stateDir: string;
        readonly reason: string;
    } | undefined;
    readonly processJobsProtectionPosture?: ProcessJobsProtectionPosture | undefined;
    readonly processStartMs: number;
    stopped: boolean;
    staleRunsReconciled: boolean;
    traceabilityStatusValue: TraceabilityStatus;
    exporterStatusValue: ExporterStatus;
    sandboxStatusValue: SandboxStatus;
    memoryHealthValue: TraceSourceMemoryHealth;
    memoryHealthRefreshDue: boolean;
    memoryHealthGeneration: number;
    startupCompleted: boolean;
    startupTimingValue: {
        readonly durationMs: number;
        readonly phases: Readonly<Record<string, number>>;
    } | undefined;
    selectedSkillsValue: readonly string[] | undefined;
    sessionMetadataValue: SessionTraceMetadata | undefined;
    resolvedExporter: ResolvedExporter | undefined;
    traceSource: TraceSourceHandle | undefined;
    globalTraceSource: TraceSourceHandle | undefined;
    traceRefreshInFlight: Promise<void> | undefined;
    traceRefreshDirty: boolean;
    traceRefreshLatestReason: string | undefined;
    activeTransports(): readonly string[];
    traceMetadata(reason: string): Record<string, unknown>;
    refreshSelectedSkillsSnapshot(reason: string): Promise<void>;
    refreshMemoryHealthSnapshot(reason: string, lifecycleForce?: boolean): Promise<TraceSourceMemoryHealth>;
    startMemoryHealthRefreshLoop(intervalMs: number): void;
    clearMemoryHealthRefreshTimer(): void;
    restartArtifactRetentionScheduler(artifactDir: string, reason: string): void;
    sandboxEngineFor(coreConfig: MonoAgentConfig): SandboxEngine | undefined;
    refreshTraceSource(reason: string): Promise<void>;
    invalidateMemoryHealthRefresh(): void;
    rememberSelectedSkills(coreConfig: MonoAgentConfig): void;
}
export declare function startTraceability(controller: TraceabilityControllerPort, reason: string): Promise<TraceabilityStatus>;
export declare function refreshSandboxStatus(controller: TraceabilityControllerPort, reason: string): Promise<SandboxStatus>;
export declare function reconcileStaleRunsOnce(controller: TraceabilityControllerPort, artifactDir: string): Promise<void>;
export declare function startExporters(controller: TraceabilityControllerPort, reason: string): Promise<ExporterStatus>;
export declare function recordExporterWarning(controller: TraceabilityControllerPort, warning: {
    phase: string;
    message: string;
}): void;
export declare function refreshTraceSource(controller: TraceabilityControllerPort, reason: string): Promise<void>;
export declare function observabilityContext(controller: TraceabilityControllerPort): Promise<{
    readonly sourceId?: string;
    readonly sourceLabel?: string;
    readonly configPath?: string;
}>;
export declare function reportMemoryRecallStatus(controller: TraceabilityControllerPort, coreConfig: MonoAgentConfig, service: MemoryRetrievalService | undefined): boolean;
export declare function stopTraceSource(controller: TraceabilityControllerPort, reason: string): Promise<void>;
export declare function refreshSelectedSkillsSnapshot(controller: TraceabilityControllerPort, reason: string): Promise<void>;
export declare function rememberSelectedSkills(controller: TraceabilityControllerPort, coreConfig: MonoAgentConfig): void;
export declare function recordSessionEvent(controller: TraceabilityControllerPort, event: ConfiguredAgentSessionEvent, coreConfig: MonoAgentConfig): void;
export declare function traceMetadata(controller: TraceabilityControllerPort, reason: string): Record<string, unknown>;
//# sourceMappingURL=app-controller-traceability.d.ts.map