/**
 * Where the Skills API lives, for this process, right now.
 *
 * This module is a thin reading of `fleet-credentials.ts`, which is itself a
 * thin reading of `@hasna/contracts/client`. It exists only so the two failure
 * MODES stay named:
 *
 *   - Read paths fail closed: `resolveApiUrl()` returns `undefined` only under
 *     the explicit local opt-in (`HASNA_SKILLS_LOCAL=1`, alias `SKILLS_LOCAL=1`),
 *     and the caller keeps working against the bundled local registry. Without
 *     the opt-in, an install with nothing configured is a refusal, not a URL.
 *   - Auth and write paths fail loudly: `requireApiUrl()` throws an error naming
 *     the missing configuration.
 *
 * Boundary rule (R1), unchanged in substance: an install with NO credential
 * produces no URL at all. The fleet gateway default in the shared seam applies
 * only once a credential has resolved, so an unconfigured OSS install still
 * names no host — see `resolveSkillsFleet`.
 *
 * A URL that IS configured while no credential resolves does not fall back to
 * local: it throws (SkillsFleetCredentialError). Reading local data because
 * authentication is unconfigured is the false green this ladder exists to
 * remove.
 */
import { type SkillsFleetOptions } from "./fleet-credentials.js";
/** The canonical env name. The unprefixed `SKILLS_API_URL` alias is still read. */
export declare const API_URL_ENV_VAR: string;
/** Hint shown wherever a Skills API URL is required but absent. */
export declare const MISSING_API_URL_HINT: string;
/** Kept under its old name: callers and tests match on this identity. */
export { MissingSkillsFleetError as MissingApiUrlError } from "./fleet-credentials.js";
type Env = Record<string, string | undefined>;
/**
 * Resolve the Skills origin in effect, or `undefined` when this install has
 * neither a credential nor an authority — i.e. runs on this machine.
 *
 * Throws when an authority IS configured and no credential resolves.
 */
export declare function resolveApiUrl(env?: Env, options?: SkillsFleetOptions): string | undefined;
/**
 * Resolve the Skills origin, or throw naming what is missing. Use this on every
 * auth and write path.
 */
export declare function requireApiUrl(action?: string, env?: Env, options?: SkillsFleetOptions): string;