/**
 * The runtime an agent really runs on, for code that only knows the
 * member's configured runtime.
 *
 * While an agent runs on a fallback runtime (its runtime ran out of usage)
 * the member record still names its configured runtime. Every place that
 * decides HOW to talk to a session (PTY heuristics, Ctrl+C, delivery,
 * activity detection) asks {@link effectiveRuntimeType} instead.
 *
 * This module holds only the hooks the RuntimeFallbackService registers, so
 * importing it is cheap and cycle-free; with no service registered every
 * function is a no-op that returns the configured value.
 *
 * @module services/runtime-fallback/effective-runtime
 */
/** Where a usage-limit report came from. */
export type RuntimeOutputSource = 'output' | 'screen' | 'error';
/** What {@link resolveLaunchRuntime} decided. */
export interface LaunchRuntimeDecision {
    /** Runtime to launch */
    runtime: string;
    /** True when it is not the configured runtime (a fallback) */
    overridden: boolean;
    /** Model to run when the fallback is the Crewly Agent (provider/model) */
    crewlyAgentModel?: string;
    /** One of the owner's other Claude Code accounts to run on (issue #942) */
    claudeAccount?: string;
}
/** Input of a launch decision. */
export interface LaunchRuntimeInput {
    sessionName: string;
    /** The member's (or orchestrator's) configured runtime */
    configured: string;
    memberId?: string;
    teamId?: string;
    isOrchestrator: boolean;
}
/** Hooks the RuntimeFallbackService provides. */
export interface RuntimeFallbackHooks {
    /** Runtime a session runs on instead of its configured one, or null (never carries an account) */
    overrideFor(sessionName: string): string | null;
    /** The owner's other Claude Code account a session runs on, or null (its runtime's default login) */
    accountFor(sessionName: string): string | null;
    /** A session's login expired: true when the fallback owns it (the session runs on another account) */
    reportLoginExpiry(sessionName: string): boolean;
    /** Runtime to launch a session on (may start a fallback for an exhausted runtime) */
    resolveLaunch(input: LaunchRuntimeInput): Promise<LaunchRuntimeDecision>;
    /** Before a message is written into a session: deliver now, or queue it (a switch is running / needed) */
    beforeDelivery(sessionName: string, runtime: string): 'deliver' | 'queue';
    /** Runtime output / error text of a session, checked for a usage limit */
    reportOutput(sessionName: string, runtime: string, text: string, source: RuntimeOutputSource): boolean;
    /** One-time note for the session's next kickoff (after a switch), consumed */
    takeKickoffNote(sessionName: string): string | null;
    /** The session's model just answered with a tool call: its runtime target has usage (optional) */
    reportWorking?(sessionName: string): void;
}
/**
 * Register (or clear) the hooks.
 *
 * @param next - Hooks, or null
 */
export declare function setRuntimeFallbackHooks(next: RuntimeFallbackHooks | null): void;
/**
 * The runtime a session actually runs on.
 *
 * @param sessionName - Session name (undefined → configured)
 * @param configured - Its configured runtime
 * @returns The fallback runtime while one is active, else `configured`
 *
 * @example
 * ```ts
 * const runtime = effectiveRuntimeType(member.sessionName, member.runtimeType as RuntimeType);
 * ```
 */
export declare function effectiveRuntimeType<T extends string>(sessionName: string | undefined | null, configured: T): T;
/**
 * The owner's other Claude Code account a session runs on (issue #942).
 *
 * @param sessionName - Session name
 * @returns Account name, or null when it runs on its runtime's default login
 *
 * @example
 * ```ts
 * const account = effectiveClaudeAccount(sessionName); // 'work' while on claude-code@work
 * ```
 */
export declare function effectiveClaudeAccount(sessionName: string | undefined | null): string | null;
/**
 * Report an expired login of a session. A session on one of the owner's
 * other Claude Code accounts is the fallback's: that account is marked
 * signed out and the agent moves on along its chain; the default login's
 * expiry stays with the re-login flow.
 *
 * @param sessionName - Session whose output showed the expiry
 * @returns True when the fallback handled it (the caller must not start a re-login)
 */
export declare function reportRuntimeLoginExpiry(sessionName: string | undefined | null): boolean;
/**
 * Decide the runtime to launch a session on.
 *
 * @param input - Session and its configured runtime
 * @returns The decision (configured runtime when no hooks are registered)
 */
export declare function resolveLaunchRuntime(input: LaunchRuntimeInput): Promise<LaunchRuntimeDecision>;
/**
 * Gate before a delivery.
 *
 * @param sessionName - Target session
 * @param runtime - Runtime the caller resolved
 * @returns `queue` when the message must wait for a runtime switch
 */
export declare function runtimeFallbackBeforeDelivery(sessionName: string, runtime: string): 'deliver' | 'queue';
/**
 * Report runtime output (live chunk, screen, or an error) for usage-limit detection.
 *
 * @param sessionName - Session
 * @param runtime - Runtime it runs on
 * @param text - Output / error text (never logged)
 * @param source - Where it came from
 * @returns True when a usage limit was recognised
 */
export declare function reportRuntimeOutput(sessionName: string, runtime: string, text: string, source: RuntimeOutputSource): boolean;
/**
 * Take the note a session's next kickoff should carry after a switch.
 *
 * @param sessionName - Session
 * @returns The note, once, or null
 */
export declare function takeRuntimeSwitchKickoffNote(sessionName: string): string | null;
/**
 * Report that a session's model just answered (a Claude Code PreToolUse
 * hook: the model produced a tool call, which it cannot do while its account
 * is out of usage). Clears a stale "out of usage" mark on the runtime target
 * the session runs on.
 *
 * @param sessionName - Session the hook came from
 *
 * @example
 * ```ts
 * if (event === 'PreToolUse') reportRuntimeWorking(sessionName);
 * ```
 */
export declare function reportRuntimeWorking(sessionName: string | undefined | null): void;
//# sourceMappingURL=effective-runtime.d.ts.map