import { RichTextTriggerProvider, RichTextTriggerQueryInput, RichTextTriggerInsertResult } from '@tutti-os/ui-rich-text/types';
import { TuttiExternalAtProviderId } from '@tutti-os/workspace-external-core/contracts';

declare const AGENT_CONTEXT_MENTION_PROVIDER_IDS: {
    readonly agentGeneratedFile: "agent-generated-file";
    readonly agentSession: "agent-session";
    readonly agentTarget: "agent-target";
    readonly file: "file";
    readonly workspaceApp: "workspace-app";
    readonly workspaceIssue: "workspace-issue";
};
type AgentContextMentionProviderId = TuttiExternalAtProviderId;
type AgentContextMentionQueryInput = RichTextTriggerQueryInput & {
    trigger: "@";
};
interface AgentContextMentionDirectoryDescriptor {
    /** Canonical provider-owned directory path used for child queries. */
    path: string;
    /** Number of direct children when the provider can determine it. */
    childCount?: number | null;
}
type AgentContextMentionDirectoryQueryInput = AgentContextMentionQueryInput & {
    directoryPath: string;
};
type AgentContextMentionInsertResult = RichTextTriggerInsertResult;
type AgentContextMentionProvider<TItem = any> = Omit<RichTextTriggerProvider<TItem>, "trigger"> & {
    trigger: "@";
    /** Optional hierarchy contract for file providers. */
    getItemDirectory?(item: TItem): AgentContextMentionDirectoryDescriptor | null | undefined;
    /** Lists the direct children of one directory without overloading keyword search. */
    queryDirectory?(input: AgentContextMentionDirectoryQueryInput): Promise<readonly TItem[]> | readonly TItem[];
};

export { AGENT_CONTEXT_MENTION_PROVIDER_IDS, type AgentContextMentionDirectoryDescriptor, type AgentContextMentionDirectoryQueryInput, type AgentContextMentionInsertResult, type AgentContextMentionProvider, type AgentContextMentionProviderId, type AgentContextMentionQueryInput };