/**
 * manager-types.ts, the ports and configuration surface of the trigger
 * supervisor.
 *
 * Split out of manager.ts so the supervisor's wiring contract can be read (and
 * implemented by a host, or faked by a test) without paging through the
 * lifecycle logic that consumes it. Everything with an effect the supervisor
 * needs, running an agent turn, running a confirmed grant, supervising a
 * long-lived command, arrives through one of these interfaces.
 */
import type { TriggerProcessHost } from './process-triggers.js';
import type { ProbeIo } from './probes.js';
import { type TriggerRetentionPolicy } from './store.js';
import type { TriggerActionGrant } from './types.js';
/** Runs the payload when a trigger fires. Hosts wire the real runtime. */
export interface TriggerActionExecutor {
    runAgentTurn(input: {
        readonly triggerId: string;
        readonly prompt: string;
        readonly sessionId?: string | undefined;
        readonly model?: string | undefined;
    }): Promise<string>;
    runGrant(input: {
        readonly triggerId: string;
        readonly grant: TriggerActionGrant;
    }): Promise<string>;
}
/** Supervises a long-lived command and delivers its output as it arrives. */
export interface TriggerStreamHost {
    start(input: {
        readonly triggerId: string;
        readonly command: string;
        readonly args: readonly string[];
        readonly cwd?: string | undefined;
        readonly onChunk: (chunk: string) => void;
        readonly onExit: (exitCode: number | null) => void;
    }): Promise<{
        readonly streamId: string;
        readonly pid: number;
    }>;
    stop(streamId: string): void;
}
/** The resolved `watchers.triggers.*` settings the supervisor reads. */
export interface TriggerManagerConfig {
    readonly enabled: boolean;
    readonly backoffLadderMs?: string | undefined;
    readonly breakerStrikes?: number | undefined;
    readonly defaultCheckIntervalMs?: number | undefined;
    readonly probeTimeoutMs?: number | undefined;
    readonly maxConcurrentChecks?: number | undefined;
    readonly observationRingSize?: number | undefined;
    readonly runHistoryLimit?: number | undefined;
    readonly runHistoryTtlHours?: number | undefined;
    readonly eventLogLimit?: number | undefined;
    readonly eventLogTtlHours?: number | undefined;
    readonly sweepIntervalMs?: number | undefined;
    readonly supervisionTickMs?: number | undefined;
    readonly streamQueueLimit?: number | undefined;
    readonly streamBatchLines?: number | undefined;
    readonly streamBatchIntervalMs?: number | undefined;
    readonly onExitMaxDurationMs?: number | undefined;
    readonly onExitStdin?: string | undefined;
    readonly outputTailBytes?: number | undefined;
}
export interface TriggerManagerOptions {
    readonly storePath: string;
    /**
     * A snapshot, or a function read on every access. Hosts pass the function
     * form so `watchers.triggers.enabled` is genuinely runtime-toggleable: with
     * a frozen snapshot, turning the flag on would do nothing until restart,
     * which is exactly the "configurable but not really" shape flags-are-features
     * forbids.
     */
    readonly config: TriggerManagerConfig | (() => TriggerManagerConfig);
    readonly actions: TriggerActionExecutor;
    readonly processHost?: TriggerProcessHost | undefined;
    readonly streamHost?: TriggerStreamHost | undefined;
    readonly probeIo?: ProbeIo | undefined;
    readonly now?: (() => number) | undefined;
    /** Stable for the lifetime of one daemon process. Drives restart detection. */
    readonly daemonBootId?: string | undefined;
    readonly sessionIsLive?: ((sessionId: string) => boolean) | undefined;
}
/**
 * Raised instead of silently doing nothing when the family is off. A watcher
 * that quietly declines to exist is the worst of both worlds, the operator
 * believes it is running.
 */
export declare class TriggerDisabledError extends Error {
    constructor(operation: string);
}
/** Turns the operator-facing hour/count settings into the store's policy shape. */
export declare function retentionFrom(config: TriggerManagerConfig): TriggerRetentionPolicy;
//# sourceMappingURL=manager-types.d.ts.map