import type { ClientToolDescriptor, HostToolEffect, HostToolExecutionResult, RemoteHostToolCall, SpotlightCommandCatalog, SpotlightHostToolsManifest, SpotlightSkill } from "@inupedia/spotlight-protocol";
import type { SpotlightHttp } from "./http.js";
export type SpotlightHostToolHandlerContext = {
    input: Record<string, unknown>;
    call: RemoteHostToolCall;
    hostEffect?: HostToolEffect;
};
export type SpotlightHostTool = {
    name: string;
    displayName?: string;
    description?: string;
    handler: (ctx: SpotlightHostToolHandlerContext) => Promise<unknown>;
};
export type SessionHostToolHandler = (call: RemoteHostToolCall, ctx: SpotlightHostToolHandlerContext) => Promise<HostToolExecutionResult>;
export declare function buildClientToolsManifest(tools: SpotlightHostTool[]): ClientToolDescriptor[];
export declare function resolveHostTools(tools: SpotlightHostTool[]): Map<string, SpotlightHostTool>;
export declare function executeHostTool(toolMap: Map<string, SpotlightHostTool>, call: RemoteHostToolCall, options: {
    allowedHostNames: Set<string>;
    hostEffect?: HostToolEffect;
    sessionToolHandler?: SessionHostToolHandler;
}): Promise<HostToolExecutionResult>;
export declare function fetchHostToolsManifest(http: SpotlightHttp, signal?: AbortSignal): Promise<SpotlightHostToolsManifest>;
export declare function resetHostToolsManifestCacheForTests(): void;
export declare function fetchDefaultCommandCatalog(http: SpotlightHttp, signal?: AbortSignal): Promise<SpotlightCommandCatalog>;
export declare function mergeCommandCatalogs(base: SpotlightCommandCatalog, overlay: SpotlightCommandCatalog | undefined | null): SpotlightCommandCatalog;
/**
 * Serialize browser-bundled Skills for the remote LangGraph runtime.
 *
 * Local source paths are intentionally removed, while the instruction body is
 * retained: a consumer-owned Skill only exists in the browser bundle and the
 * shared server cannot read that consumer's filesystem.
 */
export declare function serializeSkillsForRemote(skills: SpotlightSkill[]): SpotlightSkill[];
export declare function createSpotlightHostAdapter(options: {
    tools: SpotlightHostTool[] | (() => SpotlightHostTool[]);
}): {
    getClientToolDescriptors(): ClientToolDescriptor[];
    getToolMap(): Map<string, SpotlightHostTool>;
    executeHostTool(call: RemoteHostToolCall, execOptions: {
        allowedHostNames: Set<string>;
        hostEffect?: HostToolEffect;
        sessionToolHandler?: SessionHostToolHandler;
    }): Promise<HostToolExecutionResult>;
};
export type SpotlightHostAdapter = ReturnType<typeof createSpotlightHostAdapter>;
//# sourceMappingURL=host.d.ts.map