export declare const SKILL_AUTHORING_HANDOFF_SCHEMA_VERSION: "renma.skill-authoring-handoff.v1";
export type SkillAuthoringSourceStatus = "provided" | "consulted" | "designated_unconsulted";
export type SkillAuthoringDecisionState = "confirmed" | "proposed" | "unresolved";
export type RuntimeUnknownBehavior = "ask" | "report" | "defer" | "stop";
export type SupportingAssetKind = "context" | "context_lens";
export type SupportingAssetDisposition = "reuse" | "create";
export type SupportingAssetRelationship = "required" | "optional";
export type SkillAuthoringResource = "references" | "scripts" | "assets";
export interface SkillAuthoringCurrentUnderstanding {
    confirmed: string[];
    proposed: string[];
    unresolved: string[];
}
export interface SkillAuthoringProgression {
    blocking: string[];
    reversibleDefaults: string[];
    deferred: string[];
}
export interface SkillAuthoringContract {
    recurringTask: string;
    expectedResult: string;
    requiredInputs: string[];
    completionCriteria: string[];
    failureBehavior: string[];
    useWhen: string[];
    doNotUseWhen: string[];
}
export interface SkillAuthoringSkillAsset {
    path: string;
    id: string;
    title: string;
    owner: string;
    tags: string[];
    resources: SkillAuthoringResource[];
    requiresContext: string[];
    optionalContext: string[];
    requiresLens: string[];
    optionalLens: string[];
}
export interface SkillAuthoringSupportingAsset {
    kind: SupportingAssetKind;
    id: string;
    path: string;
    disposition: SupportingAssetDisposition;
    relationship: SupportingAssetRelationship;
    justification: string;
}
export interface SkillAuthoringSourceAuthority {
    source: string;
    status: SkillAuthoringSourceStatus;
    authority?: string;
    evidence?: string[];
}
export interface SkillAuthoringSecurityDecision {
    decision: string;
    state: SkillAuthoringDecisionState;
    rationale?: string;
}
export interface SkillAuthoringRuntimeUnknownHandling {
    unknown: string;
    behavior: RuntimeUnknownBehavior;
    condition?: string;
}
export interface SkillAuthoringHandoff {
    schemaVersion: typeof SKILL_AUTHORING_HANDOFF_SCHEMA_VERSION;
    topic: "skill";
    currentUnderstanding: SkillAuthoringCurrentUnderstanding;
    progression: SkillAuthoringProgression;
    skillContract: SkillAuthoringContract;
    assetGraph: {
        skill: SkillAuthoringSkillAsset;
        supportingAssets: SkillAuthoringSupportingAsset[];
    };
    sourceAuthorities: SkillAuthoringSourceAuthority[];
    securityDecisions: SkillAuthoringSecurityDecision[];
    runtimeUnknownHandling: SkillAuthoringRuntimeUnknownHandling[];
}
/** Read and validate caller-declared authoring evidence without repository or network access. */
export declare function readSkillAuthoringHandoff(handoffPath: string): Promise<SkillAuthoringHandoff>;
/** Preserve unexpected read failures while classifying narrow caller-correctable path errors. */
export declare function classifySkillAuthoringHandoffReadError(error: unknown, handoffPath: string): unknown;
/** Require the explicit side-effect target to match the handoff Skill path. */
export declare function validateSkillAuthoringHandoffTarget(handoff: SkillAuthoringHandoff, targetPath: string): void;
/** Validate canonical Skill identity and semantic asset-graph consistency. */
export declare function validateSkillAuthoringHandoffIdentityAndGraph(handoff: SkillAuthoringHandoff): void;