import { type FacetType } from '../paths.js';
import { type FacetResolutionContext } from './workflowPackageScope.js';
export interface WorkflowSections {
    personas?: Record<string, string>;
    resolvedPolicies?: Record<string, string>;
    resolvedPoliciesWithSource?: ResolvedSectionMap;
    resolvedKnowledge?: Record<string, string>;
    resolvedKnowledgeWithSource?: ResolvedSectionMap;
    resolvedInstructions?: Record<string, string>;
    resolvedInstructionsWithSource?: ResolvedSectionMap;
    resolvedReportFormats?: Record<string, string>;
    resolvedReportFormatsWithSource?: ResolvedSectionMap;
}
export { isResourcePath, resolveResourcePath, resolveSectionMap, extractPersonaDisplayName, isScopeRef, } from 'faceted-prompting';
export type { FacetResolutionContext } from './workflowPackageScope.js';
export interface ResolvedFacetContent {
    content: string;
    sourcePath?: string;
    facetType?: FacetType;
    refName?: string;
    literalContent?: true;
}
export type ResolvedSectionMap = Record<string, ResolvedFacetContent>;
type ResolvedMapInput = Record<string, string> | ResolvedSectionMap;
export declare function unwrapResolvedSectionMap(map: ResolvedSectionMap | undefined): Record<string, string> | undefined;
export declare function resolveResourceContentWithSource(spec: string | undefined, workflowDir: string, facetType?: FacetType, refName?: string, context?: FacetResolutionContext, trustedRoot?: string, requireFile?: boolean, selectorInstruction?: boolean): ResolvedFacetContent | undefined;
export declare function resolveSectionMapWithSource(raw: Record<string, string> | undefined, workflowDir: string, facetType: FacetType, context?: FacetResolutionContext, trustedRoot?: string, selectorInstructionRefs?: ReadonlySet<string>): ResolvedSectionMap | undefined;
export declare function resolveFacetPath(name: string, facetType: FacetType, context: FacetResolutionContext): string | undefined;
export declare function resolveFacetByName(name: string, facetType: FacetType, context: FacetResolutionContext): string | undefined;
export declare function resolveFacetByNameWithSource(name: string, facetType: FacetType, context: FacetResolutionContext): ResolvedFacetContent | undefined;
export declare function resolveRefToContent(ref: string, resolvedMap: ResolvedMapInput | undefined, workflowDir: string, facetType?: FacetType, context?: FacetResolutionContext): string | undefined;
export interface ResolveRefToContentWithSourceOptions {
    /**
     * 当該呼出が facet pool の自己完結解決（context === undefined）のように
     * bare facet name への最終フォールバックを許可しない境界で実行されている場合 true。
     * true のとき、context === undefined かつ bare ref（`isResourcePath(ref)` false・
     * `isScopeRef(ref)` false）が section map・candidate dirs のいずれでも解決できなかった
     * 場合は、ref 名を content とする最終フォールバックを skip し undefined を返す。
     * 呼出元は undefined を fail-fast として扱う。既存の汎用呼出元は未指定で従来通り
     * 最終フォールバックを維持する。
     */
    readonly strictBareName?: boolean;
    /**
     * external facet pool 境界など、facet ファイル解決後に resolved パスが
     * 指定 root に留まることを検証する必要がある呼出元で指定する。
     * `resolveResourceContentWithSource` が read 前に `assertPathSegmentsAreSafe`
     * で境界チェックを行う。未指定の場合は従来通りの境界チェック動作を維持する。
     */
    readonly trustedRoot?: string;
    /**
     * true のとき、.md パス参照がファイルに解決できない場合は undefined を返さず
     * fail-fast で例外を投げる。facet pool の候補参照など、存在しない .md が
     * リテラル文字列として本文に混入するのを防ぐために指定する。
     */
    readonly requireFile?: boolean;
    /** selector instruction の path-like resource を許可 facet root に限定する。 */
    readonly selectorInstruction?: boolean;
}
export declare function resolveSelectorInstruction(ref: string, resolvedMap: ResolvedMapInput | undefined, workflowDir: string, context?: FacetResolutionContext): string | undefined;
export declare function resolveRefToContentWithSource(ref: string, resolvedMap: ResolvedMapInput | undefined, workflowDir: string, facetType?: FacetType, context?: FacetResolutionContext, options?: ResolveRefToContentWithSourceOptions): ResolvedFacetContent | undefined;
export declare function resolveRefList(refs: string | string[] | undefined, resolvedMap: ResolvedMapInput | undefined, workflowDir: string, facetType?: FacetType, context?: FacetResolutionContext): string[] | undefined;
export declare function resolveRefListWithSource(refs: string | string[] | undefined, resolvedMap: ResolvedMapInput | undefined, workflowDir: string, facetType?: FacetType, context?: FacetResolutionContext): ResolvedFacetContent[] | undefined;
export declare function resolvePersona(rawPersona: string | undefined, sections: WorkflowSections, workflowDir: string, context?: FacetResolutionContext): {
    personaSpec?: string;
    personaPath?: string;
};
//# sourceMappingURL=resource-resolver.d.ts.map