export declare const PAPERCLIP_MCP_SERVER_NAME = "paperclip";
export declare const PAPERCLIP_MCP_PACKAGE = "@tickernelz/paperclip-pro-mcp-server";
export declare const PAPERCLIP_MCP_BIN = "paperclip-mcp-server";
export declare const PAPERCLIP_MCP_DEFAULT_TOOLSETS = "core";
export declare const PAPERCLIP_MCP_TOOLSETS_ENV = "PAPERCLIP_MCP_TOOLSETS";
export declare const PAPERCLIP_MCP_HTTP_PATH = "/mcp/paperclip";
export declare const PAPERCLIP_MCP_RUN_ID_HEADER = "X-Paperclip-Run-Id";
/** Which Paperclip access surface an adapter arms for a run. */
export type PaperclipAccessMode = "mcp" | "rest";
export type PaperclipMcpTransportKind = "http" | "stdio";
export interface PaperclipMcpCommand {
    command: string;
    args: string[];
    source: "bin" | "dist" | "path";
}
export declare function paperclipMcpToolsets(config: Record<string, unknown>): string;
export declare function paperclipMcpTransport(config: Record<string, unknown>): PaperclipMcpTransportKind;
/** Server-hosted MCP endpoint for this run, mirroring the API base the REST path uses. */
export declare function paperclipMcpEndpoint(apiUrl: string, toolsets: string): string;
/** MCP needs the `paperclipMcp` toggle on plus an API base and a run credential; everything else is REST. */
export declare function paperclipAccessMode(config: Record<string, unknown>, env: Record<string, string | undefined>): PaperclipAccessMode;
export declare function paperclipMcpHttpHeaders(input: {
    apiKey: string;
    runId?: string;
}): Record<string, string>;
/** Locate the stdio MCP server shipped with this install: nearest `.bin` shim, then `dist/stdio.js`, then PATH. */
export declare function resolvePaperclipMcpServerCommand(options?: {
    searchFrom?: string;
    exists?: (candidate: string) => boolean;
    nodePath?: string;
}): PaperclipMcpCommand;
export interface PaperclipMcpServerEntryInput {
    enabled: boolean;
    transport: PaperclipMcpTransportKind;
    command: PaperclipMcpCommand;
    toolsets: string;
    env: Record<string, string>;
    /** `placeholder` emits `${PAPERCLIP_API_KEY}` for runtimes that expand env references; `literal` writes the token. */
    credential?: "placeholder" | "literal";
}
export declare function buildPaperclipMcpServerEntry(input: PaperclipMcpServerEntryInput): Record<string, unknown>;
export declare function renderPaperclipMcpConfig(input: PaperclipMcpServerEntryInput): string;
export declare function paperclipMcpGuidance(toolsets: string, toolCount?: number | null): string;
/** Guidance for runtimes without the Paperclip MCP: reach the board over REST with the run credentials in env. */
export declare function paperclipRestGuidance(options?: {
    shellHint?: string;
}): string;
export declare function paperclipAccessGuidance(access: PaperclipAccessMode, options?: {
    toolsets?: string;
    toolCount?: number | null;
    shellHint?: string;
}): string;
//# sourceMappingURL=paperclip-mcp.d.ts.map