import type { ChannelSourceRef } from "#discover/manifest.js";
import type { CompiledChannelDefinition } from "#compiler/manifest.js";
import { type ModuleBackedDefinitionLoadOptions } from "#compiler/normalize-helpers.js";
/**
 * Compiles one authored channel module into the normalized channel
 * entries stored on the compiled agent manifest.
 *
 * Recognizes the `disableRoute()` sentinel and emits a `disabled`
 * entry so the runtime can short-circuit channel registration without
 * losing the source path for diagnostics.
 *
 * Authored channels are always `CompiledChannel` values (from
 * `defineChannel`). Each route in the channel's `routes` array becomes
 * a separate compiled channel entry. The channel name is derived from
 * the filesystem path; the URL path comes from the route's `path` field.
 */
export declare function compileChannelDefinition(_agentRoot: string, source: ChannelSourceRef, options: ModuleBackedDefinitionLoadOptions): Promise<{
    readonly kind: "disabled";
    readonly name: string;
} | {
    readonly definitions: readonly CompiledChannelDefinition[];
    readonly kind: "channel";
}>;