import { type JevCandidate } from "../../agent/jev-tool-prefetch.js";
import { type FrameworkToolGroup } from "../../framework-tools.js";
import type { ContextStatus } from "../../shared/context-status.js";
import type { ContextGovernanceTier, ContextManifestSourceRef, ContextSystemProvenance } from "../../shared/context-xray.js";
import { type OrgDirectoryStatus } from "../agent-discovery.js";
import type { BuilderGatewayAuth } from "../credential-provider.js";
export declare const COMPACT_PROMPT_RESOURCE_MAX_CHARS = 6000;
export declare const COMPACT_PROMPT_RESOURCES_TOTAL_MAX_CHARS = 48000;
export interface PromptContextProviderContext {
    owner: string;
    compact: boolean;
    selfAppId?: string;
    orgId: string | null;
}
export interface PromptContextProviderContribution {
    content: string;
    label?: string;
    provenance?: ContextSystemProvenance;
    governance?: ContextGovernanceTier;
    sourceRef?: ContextManifestSourceRef;
}
export interface PromptContextProvider {
    id: string;
    failOnError?: boolean;
    load(context: PromptContextProviderContext): Promise<PromptContextProviderContribution | null | undefined> | PromptContextProviderContribution | null | undefined;
}
export declare function registerPromptContextProvider(provider: PromptContextProvider): () => void;
export declare function compactPromptLine(value: string, maxChars: number): string;
export interface JevPromptContextCandidate extends JevCandidate {
    kind?: string;
    name: string;
    scope: string;
    path?: string;
    content: string;
}
export interface PromptResourceManifestSection {
    label: string;
    provenance: ContextSystemProvenance;
    governance: ContextGovernanceTier;
    content: string;
    sourceRef?: ContextManifestSourceRef;
}
export declare function promptResourceManifestSections(prompt: string): PromptResourceManifestSection[];
/** The compact prompt's skills index. `skillReadTool` is the tool the request
 *  registry actually has for reading a skill; with none, the index is dropped
 *  because it would send the model to a tool it cannot call. */
export declare function buildCompactSkillsSummary(skills: ReadonlyArray<{
    meta: {
        name: string;
        description?: string;
    };
}>, skillReadTool: string | null): string | null;
/** @internal exported for unit tests only */
export declare function promptResourceBlock(input: {
    name: string;
    scope: string;
    content: string;
    path?: string;
    maxChars?: number;
    readHint?: string | null;
}): string | null;
export interface PromptSection {
    content: string;
    governance: ContextGovernanceTier;
}
export interface SkippedPromptSection {
    label: string;
    chars: number;
}
export interface PromptSectionBudgetResult {
    sections: string[];
    skipped: SkippedPromptSection[];
    overflowChars: number;
}
export declare function selectPromptSectionsWithinBudget(sections: PromptSection[], maxChars: number, runtimeToolHints?: boolean): PromptSectionBudgetResult;
export declare function resourceScopeForOwner(owner: string, currentOwner?: string): string;
export interface JevPreloadResult {
    context: string;
    status: ContextStatus;
    relevantAppsContext?: string;
    appSelection?: AppDiscoverySelectionDiagnostic;
}
export interface AppDiscoverySelectionDiagnostic {
    status: "selected" | "no-match" | "unavailable" | "failed" | "timed_out";
    directoryStatus: OrgDirectoryStatus["status"];
    selectedIds: string[];
    latencyMs: number;
}
export declare function preloadJevContextForPrompt(options: Parameters<typeof preloadJevContextWithStatus>[0]): Promise<string>;
export declare function preloadJevContextWithStatus(options: {
    request: string;
    appRequest?: string;
    appId?: string;
    selfAppId?: string;
    workspaceAppsEnabled?: boolean;
    appDiscoveryOnly?: boolean;
    owner?: string;
    orgId?: string | null;
    apiKey?: string;
    personalApiKey?: string;
    directApiKey?: string;
    builderAuth?: BuilderGatewayAuth | null;
    candidates?: readonly JevPromptContextCandidate[];
    fallbackCandidateIds?: readonly string[];
    compact?: boolean;
    maxChars?: number;
    contextPrefetchDeadlineAt?: number;
    dispatchToBackground?: boolean;
    internalContinuation?: boolean;
}): Promise<JevPreloadResult>;
/**
 * Pre-load the agent's context: AGENTS.md (workspace/template/runtime
 * instructions), the skills index, shared LEARNINGS.md (team notes), a shared
 * resource index, and memory/MEMORY.md (personal structured memory index).
 * These all get appended to the system prompt so the agent has everything it
 * needs from the first turn.
 *
 * Six sources are layered:
 *
 *   1. `<workspace>` — AGENTS.md from the enterprise workspace core.
 *   2. `<template>` — AGENTS.md + skills index from the Vite plugin bundle.
 *   3. `<workspace>` — SQL workspace AGENTS.md and instructions/*.md.
 *      Runtime global defaults managed from Dispatch and inherited by apps.
 *   4. `<app-default>` — legacy app-wide SQL defaults.
 *   5. `<shared>` — organization AGENTS.md, instructions, and LEARNINGS.md.
 *      These are isolated by active org and override app/workspace defaults.
 *   6. `<personal>` — memory/MEMORY.md from the SQL personal scope. The
 *      current user's structured memory index.
 *
 * Each source is read independently — no copying between them. Editing
 * AGENTS.md and restarting the server is all it takes; Vite HMR invalidates
 * the bundle in dev so changes land instantly.
 */
export declare function loadResourcesForPrompt(owner: string, compact?: boolean, selfAppId?: string, orgId?: string | null, opts?: {
    disabledFrameworkGroups?: ReadonlySet<FrameworkToolGroup>;
    requestText?: string;
    /** The tool the compact skills summary sends the model to for skill text,
     *  or `null` when the request registry has none. Omitted means
     *  `docs-search`, the framework default. */
    skillReadTool?: string | null;
    /** Omit framework runtime lookup hints when those tools are unavailable. */
    runtimeToolHints?: boolean;
    /** Absolute deadline for optional app discovery shared with prompt preload. */
    promptPreloadDeadlineAt?: number;
}): Promise<string>;