/**
 * Authored prompt layer descriptors and manifest composition.
 *
 * Implements the v1 surface from the "Agent Layer Versioning" proposal:
 *
 *   - typed descriptor for each authored prompt layer
 *     (PilotSwarm base, app base, active agent)
 *   - compact in-prompt manifest text rendered above the framework header
 *   - JSON-serializable payload for the `session.prompt_layers` event
 *
 * Runtime context (sub-agent injection, rehydration overlays) is NOT a
 * versioned agent layer in v1. Its behavior is governed by the orchestration
 * version and session/runtime metadata.
 *
 * @module
 */
export type PromptLayerKind = "pilotswarm_base" | "app_base" | "agent";
export type PromptLayerType = "system" | "app";
export interface PromptLayerDescriptor {
    /** Authored role of the layer in the precedence stack. */
    layerKind: PromptLayerKind;
    /** Stable identifier suitable for log/event correlation. */
    layerId: string;
    /** Author-facing name (matches `.agent.md` frontmatter `name`). */
    name: string;
    /** Schema family the frontmatter was authored against. */
    schemaVersion: string;
    /** Author-supplied version string (recommended SemVer for system layers). */
    version: string;
    /** Whether this layer was authored by PilotSwarm/system or by an app/user. */
    type: PromptLayerType;
    /** Optional source path or namespace for diagnostics. */
    source?: string;
}
/** Build the canonical schema identifier (`pilotswarm.agent.v{n}`). */
export declare function buildSchemaIdentifier(schemaVersion: number | string | undefined | null): string;
/** Compose the human-readable prompt-layer manifest text. */
export declare function renderPromptLayerManifest(layers: ReadonlyArray<PromptLayerDescriptor>): string | undefined;
/** Stable, JSON-serializable payload for the `session.prompt_layers` event. */
export interface PromptLayersEventPayload {
    schemaVersion: 1;
    layers: PromptLayerDescriptor[];
}
export declare function buildPromptLayersEventPayload(layers: ReadonlyArray<PromptLayerDescriptor>): PromptLayersEventPayload;
//# sourceMappingURL=prompt-layers.d.ts.map