import { type Icon } from '@frontmcp/protocol';
import { type EntryAvailability } from '@frontmcp/utils';
declare global {
    /**
     * Declarative metadata extends to McpResource decorator.
     */
    export interface ExtendFrontMcpResourceMetadata {
    }
    /**
     * Declarative metadata extends to McpResourceTemplate decorator.
     */
    export interface ExtendFrontMcpResourceTemplateMetadata {
    }
}
/**
 * MCP `Annotations` object on a resource. Mirrors the MCP spec's
 * `Annotations` shape — used to give hosts hints about audience,
 * priority, and modification time.
 */
export interface ResourceAnnotations {
    /**
     * The intended consumer(s). E.g. `["assistant"]` for content the model
     * should load, `["user", "assistant"]` for content the host may show in
     * a UI as well.
     */
    audience?: Array<'user' | 'assistant'>;
    /**
     * Display priority hint in the range [0, 1]. Higher values surface
     * earlier under progressive disclosure. SEP-2640 recommends 0.8 for
     * the primary `SKILL.md` and ~0.3 for support files.
     */
    priority?: number;
    /** ISO 8601 timestamp of the last modification. Useful for cache invalidation. */
    lastModified?: string;
}
/**
 * A known resource that the server is capable of reading.
 */
interface ResourceMetadata extends ExtendFrontMcpResourceMetadata {
    /** Intended for programmatic or logical use, but used as a display name in past specs or fallback */
    name: string;
    /**
     * Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
     * even by those unfamiliar with domain-specific terminology.
     *
     * If not provided, the name should be used for display (except for Tool,
     * where `annotations.title` should be given precedence over using `name`,
     * if present).
     */
    title?: string;
    /**
     * The URI of this resource.
     */
    uri: string;
    /**
     * A description of what this resource represents.
     *
     * This can be used by clients to improve the LLM's understanding of available resources. It can be thought of like a "hint" to the model.
     */
    description?: string;
    /**
     * The MIME type of this resource, if known.
     */
    mimeType?: string;
    /**
     * A list of icons that can be used to represent this resource template.
     */
    icons?: Icon[];
    /**
     * MCP annotations for the resource. Forwarded verbatim in
     * `resources/list` so hosts can route based on `audience`, `priority`,
     * and `lastModified`.
     */
    annotations?: ResourceAnnotations;
    /**
     * Free-form metadata forwarded in `resources/list` and `resources/read`
     * responses. Reserve reverse-DNS prefixed keys (e.g.
     * `io.modelcontextprotocol.skills/...`) per the MCP spec.
     */
    _meta?: Record<string, unknown>;
    /**
     * Environment availability constraint.
     * When set, the resource is only discoverable and readable in matching environments.
     */
    availableWhen?: EntryAvailability;
}
export declare const frontMcpResourceMetadataSchema: import("@frontmcp/lazy-zod").ZodObject<{
    name: import("@frontmcp/lazy-zod").ZodString;
    title: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
    uri: import("@frontmcp/lazy-zod").ZodString;
    description: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
    mimeType: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
    icons: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodObject<{
        src: import("@frontmcp/lazy-zod").ZodString;
        mimeType: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
        sizes: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
        theme: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodEnum<{
            light: "light";
            dark: "dark";
        }>>;
    }, import("zod/v4/core").$strip>>>;
    annotations: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodObject<{
        audience: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodEnum<{
            user: "user";
            assistant: "assistant";
        }>>>;
        priority: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodNumber>;
        lastModified: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
    }, import("zod/v4/core").$strict>>;
    _meta: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodRecord<import("@frontmcp/lazy-zod").ZodString, import("@frontmcp/lazy-zod").ZodUnknown>>;
    availableWhen: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodObject<{
        os: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
        platform: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
        runtime: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
        deployment: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
        provider: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
        target: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
        surface: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodEnum<{
            cli: "cli";
            mcp: "mcp";
            "http-trigger": "http-trigger";
            job: "job";
            agent: "agent";
        }>>>;
        env: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
    }, import("zod/v4/core").$strict>>;
}, import("zod/v4/core").$loose>;
/**
 * A template description for resources available on the server.
 */
interface ResourceTemplateMetadata extends ExtendFrontMcpResourceTemplateMetadata {
    /** Intended for programmatic or logical use, but used as a display name in past specs or fallback */
    name: string;
    /**
     * Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
     * even by those unfamiliar with domain-specific terminology.
     *
     * If not provided, the name should be used for display (except for Tool,
     * where `annotations.title` should be given precedence over using `name`,
     * if present).
     */
    title?: string;
    /**
     * A URI template (according to RFC 6570) that can be used to construct resource URIs.
     */
    uriTemplate: string;
    /**
     * A description of what this template is for.
     *
     * This can be used by clients to improve the LLM's understanding of available resources. It can be thought of like a "hint" to the model.
     */
    description?: string;
    /**
     * The MIME type for all resources that match this template. This should only be included if all resources matching this template have the same type.
     */
    mimeType?: string;
    /**
     * A list of icons that can be used to represent this resource template.
     */
    icons?: Icon[];
    /**
     * MCP annotations for the template. Same shape as resource annotations
     * — clients use these to route by audience/priority and invalidate
     * caches via `lastModified`.
     */
    annotations?: ResourceAnnotations;
    /**
     * Free-form metadata forwarded in `resources/list` responses; reserve
     * reverse-DNS prefixed keys per the MCP spec.
     */
    _meta?: Record<string, unknown>;
    /**
     * Environment availability constraint.
     * When set, the resource template is only discoverable in matching environments.
     */
    availableWhen?: EntryAvailability;
}
export declare const frontMcpResourceTemplateMetadataSchema: import("@frontmcp/lazy-zod").ZodObject<{
    name: import("@frontmcp/lazy-zod").ZodString;
    title: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
    uriTemplate: import("@frontmcp/lazy-zod").ZodString;
    description: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
    mimeType: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
    icons: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodObject<{
        src: import("@frontmcp/lazy-zod").ZodString;
        mimeType: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
        sizes: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
        theme: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodEnum<{
            light: "light";
            dark: "dark";
        }>>;
    }, import("zod/v4/core").$strip>>>;
    annotations: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodObject<{
        audience: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodEnum<{
            user: "user";
            assistant: "assistant";
        }>>>;
        priority: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodNumber>;
        lastModified: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
    }, import("zod/v4/core").$strict>>;
    _meta: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodRecord<import("@frontmcp/lazy-zod").ZodString, import("@frontmcp/lazy-zod").ZodUnknown>>;
    availableWhen: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodObject<{
        os: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
        platform: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
        runtime: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
        deployment: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
        provider: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
        target: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
        surface: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodEnum<{
            cli: "cli";
            mcp: "mcp";
            "http-trigger": "http-trigger";
            job: "job";
            agent: "agent";
        }>>>;
        env: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
    }, import("zod/v4/core").$strict>>;
}, import("zod/v4/core").$loose>;
export { ResourceMetadata, ResourceMetadata as FrontMcpResourceMetadata, ResourceTemplateMetadata, ResourceTemplateMetadata as FrontMcpResourceTemplateMetadata, };
//# sourceMappingURL=resource.metadata.d.ts.map