import { type BeforeWritableCommit } from '../mcp/state-paths.js';
export declare const SKILL_ACTIVE_STATE_MODE = "skill-active";
export declare const SKILL_ACTIVE_STATE_FILE = "skill-active-state.json";
export declare class SkillActiveStateWriteError extends Error {
    readonly code: 'lock-timeout' | 'lock-lost' | 'malformed-root' | 'atomic-replace-failed';
    constructor(code: SkillActiveStateWriteError['code'], message: string, options?: {
        cause?: unknown;
    });
}
export declare const CANONICAL_WORKFLOW_SKILLS: readonly ['autopilot', 'autoresearch', 'team', 'ultragoal', 'ralph', 'ultrawork', 'ultraqa', 'ralplan', 'deep-interview'];
export type CanonicalWorkflowSkill = (typeof CANONICAL_WORKFLOW_SKILLS)[number];
export interface SkillActiveEntry {
    skill: string;
    phase?: string;
    active?: boolean;
    activated_at?: string;
    updated_at?: string;
    session_id?: string;
    thread_id?: string;
    turn_id?: string;
    owner_codex_session_id?: string;
}
export interface SkillActiveStateLike {
    version?: number;
    active?: boolean;
    skill?: string;
    keyword?: string;
    phase?: string;
    activated_at?: string;
    updated_at?: string;
    source?: string;
    session_id?: string;
    thread_id?: string;
    turn_id?: string;
    owner_codex_session_id?: string;
    initialized_mode?: string;
    initialized_state_path?: string;
    input_lock?: unknown;
    active_skills?: SkillActiveEntry[];
    [key: string]: unknown;
}
export interface SyncCanonicalSkillStateOptions {
    cwd: string;
    baseStateDir?: string;
    mode: string;
    active: boolean;
    currentPhase?: string;
    sessionId?: string;
    threadId?: string;
    turnId?: string;
    ownerCodexSessionId?: string;
    nowIso?: string;
    source?: string;
    allSessions?: boolean;
    beforeCommit?: BeforeWritableCommit;
}
export declare function extractSessionIdFromInitializedStatePath(pathValue: unknown): string | undefined;
export declare function isTerminalSkillActivePhase(phase: unknown): boolean;
export declare function isTerminalSkillActiveState(state: SkillActiveStateLike): boolean;
export declare function clearTerminalSkillActiveMarkers<T extends SkillActiveStateLike>(state: T): T;
export declare function listActiveSkills(raw: unknown): SkillActiveEntry[];
/**
 * Returns whether a canonical compatibility record may speak for the requested
 * transition scope. A foreign outer session never authenticates unowned legacy
 * child entries for a root or different-session caller.
 */
export declare function isTransitionCanonicalStateOwned(raw: unknown, sessionId?: string): boolean;
export declare function listTransitionActiveSkills(raw: unknown, sessionId?: string): SkillActiveEntry[];
/** Owner metadata for read-only provenance preflight; never infers ownership from storage. */
export declare function listSkillActiveOwnerCodexSessionIds(raw: unknown): string[];
export declare function normalizeSkillActiveState(raw: unknown): SkillActiveStateLike | null;
export declare function getSkillActiveStatePaths(cwd: string, sessionId?: string): {
    rootPath: string;
    sessionPath?: string;
};
export declare function getSkillActiveStatePathsForStateDir(stateDir: string, sessionId?: string): {
    rootPath: string;
    sessionPath?: string;
};
export declare function readSkillActiveState(path: string): Promise<SkillActiveStateLike | null>;
export declare function writeSkillActiveStateCopies(cwd: string, state: SkillActiveStateLike, sessionId?: string, rootState?: SkillActiveStateLike | null): Promise<void>;
export declare function writeSkillActiveStateCopiesForStateDir(stateDir: string, state: SkillActiveStateLike, sessionId?: string, rootState?: SkillActiveStateLike | null, options?: {
    beforeCommit?: BeforeWritableCommit;
    sessionOnlyWhenRootMissing?: boolean;
}): Promise<void>;
export declare function updateRootSkillActiveStateForStateDir(stateDir: string, update: (currentRoot: SkillActiveStateLike | null) => SkillActiveStateLike | null, options?: {
    beforeCommit?: BeforeWritableCommit;
}): Promise<void>;
export declare function writeSkillActiveStateWithPrimaryTransactionForStateDir(stateDir: string, state: SkillActiveStateLike, sessionId: string, primaryPath: string, primaryWrite: () => Promise<void>, options?: {
    beforeCommit?: BeforeWritableCommit;
}): Promise<void>;
export declare function readVisibleSkillActiveState(cwd: string, sessionId?: string): Promise<SkillActiveStateLike | null>;
export declare function readVisibleSkillActiveStateForStateDir(stateDir: string, sessionId?: string): Promise<SkillActiveStateLike | null>;
export declare function tracksCanonicalWorkflowSkill(mode: string): mode is CanonicalWorkflowSkill;
export declare function syncCanonicalSkillStateForMode(options: SyncCanonicalSkillStateOptions): Promise<void>;
//# sourceMappingURL=skill-active.d.ts.map