import type { Model } from "@oh-my-pi/pi-ai";
import type { ModelRegistry } from "../config/model-registry.js";
import type { AgentDefinition } from "../task/types.js";
import { type ModelMention } from "@oh-my-pi/pi-tui/prompt/model-mention-syntax";
import type { SessionEntry } from "./session-entries.js";
import type { SessionManager } from "./session-manager.js";
/** Journal entry identifying a model the user authorized for delegation. */
export declare const MODEL_MENTION_ENTRY_TYPE = "model_mention";
/** Replay valid branch entries, keeping the first occurrence of each agent and selector. */
export declare function readModelMentions(entries: readonly SessionEntry[]): ModelMention[];
/** A `^` selector resolved within the session picker's model scope. */
export type ResolvedModelMention = Omit<ModelMention, "agent">;
/** Session capabilities needed to authorize and persist model mentions. */
export interface ModelMentionHost {
    sessionManager: SessionManager;
    modelRegistry: ModelRegistry;
    scopedModels(): ReadonlyArray<Model>;
    /** User-authorized model agents inherited from the parent session. */
    inheritedAgents?: readonly AgentDefinition[];
}
/** Owns branch-local pseudonyms for models explicitly tagged by the user. */
export declare class ModelMentionRegistry {
    #private;
    constructor(host: ModelMentionHost);
    /** Rebuild pseudonyms after resume, rewind, or a session switch. */
    syncFromBranch(): void;
    /** User-authorized model pseudonyms in first-mention order. */
    get mentions(): readonly ModelMention[];
    /**
     * Resolve `provider/id[:level]` within the session picker's model scope. Exact ids win:
     * some contain colons (`qwen3:8b`) or end in a level name (`glm-4.7:max`). A level
     * spelling whose canonical selector is another model's id (`:ma` beside a literal
     * `…:max`) stays unresolved, since dispatch would run that other model.
     */
    resolve(selector: string): ResolvedModelMention | undefined;
    /** Register user-tagged models and replace their tokens with persisted agent tags. */
    expandMentions(text: string): string;
    /** Expose inherited and session-tagged models as general-purpose task agents. */
    sessionAgents(): AgentDefinition[];
}