/**
 * Direct MCP Server - Types and Interfaces
 *
 * Provides programmatic access to FrontMCP servers without HTTP/stdio transports.
 * Useful for embedding MCP servers in existing applications, testing, and agent backends.
 */
import type { ListToolsResult, CallToolResult, ListResourcesResult, ReadResourceResult, ListPromptsResult, GetPromptResult, ListResourceTemplatesResult } from '@frontmcp/protocol';
import type { DirectClient, ConnectOptions } from './client.types';
/**
 * Auth context for direct server invocation.
 * Simulates what would come from JWT validation in the HTTP layer.
 */
export interface DirectAuthContext {
    /** Session ID for context tracking (auto-generated if not provided) */
    sessionId?: string;
    /** User/client token for authorization (e.g., JWT) */
    token?: string;
    /** User claims (extracted from token) */
    user?: {
        sub?: string;
        [key: string]: unknown;
    };
    /** Additional auth info (claims, scopes, etc.) */
    extra?: Record<string, unknown>;
}
/**
 * Request metadata for direct calls.
 */
export interface DirectRequestMetadata {
    /** User-Agent string */
    userAgent?: string;
    /** Client IP address */
    clientIp?: string;
    /** Custom headers matching x-frontmcp-* pattern */
    customHeaders?: Record<string, string>;
}
/**
 * Options for direct method calls.
 */
export interface DirectCallOptions {
    /** Auth context to inject (simulates JWT header) */
    authContext?: DirectAuthContext;
    /** Request metadata */
    metadata?: DirectRequestMetadata;
}
/**
 * Direct MCP server interface - bypasses HTTP transport layer.
 *
 * Provides programmatic access to MCP operations (tools, resources, prompts)
 * without requiring HTTP infrastructure.
 *
 * @example
 * ```typescript
 * import { FrontMcpInstance } from '@frontmcp/sdk';
 *
 * const server = await FrontMcpInstance.createDirect({
 *   info: { name: 'MyServer', version: '1.0.0' },
 *   apps: [MyApp],
 * });
 *
 * // List all tools
 * const { tools } = await server.listTools();
 *
 * // Call a tool with auth context
 * const result = await server.callTool('my-tool', { input: 'value' }, {
 *   authContext: { token: 'jwt-token', sessionId: 'user-123' }
 * });
 *
 * // Cleanup when done
 * await server.dispose();
 * ```
 */
export interface DirectMcpServer {
    /** Ready promise - resolves when server is initialized */
    readonly ready: Promise<void>;
    /**
     * List all available tools.
     *
     * @param options - Optional call options with auth context
     * @returns List of tool definitions
     */
    listTools(options?: DirectCallOptions): Promise<ListToolsResult>;
    /**
     * Call a tool with arguments.
     *
     * @param name - Tool name
     * @param args - Tool arguments
     * @param options - Optional call options with auth context
     * @returns Tool execution result
     */
    callTool(name: string, args?: Record<string, unknown>, options?: DirectCallOptions): Promise<CallToolResult>;
    /**
     * List all available resources.
     *
     * @param options - Optional call options with auth context
     * @returns List of resource definitions
     */
    listResources(options?: DirectCallOptions): Promise<ListResourcesResult>;
    /**
     * List all available resource templates.
     *
     * @param options - Optional call options with auth context
     * @returns List of resource template definitions
     */
    listResourceTemplates(options?: DirectCallOptions): Promise<ListResourceTemplatesResult>;
    /**
     * Read a resource by URI.
     *
     * @param uri - Resource URI
     * @param options - Optional call options with auth context
     * @returns Resource content
     */
    readResource(uri: string, options?: DirectCallOptions): Promise<ReadResourceResult>;
    /**
     * List all available prompts.
     *
     * @param options - Optional call options with auth context
     * @returns List of prompt definitions
     */
    listPrompts(options?: DirectCallOptions): Promise<ListPromptsResult>;
    /**
     * Get a prompt with arguments.
     *
     * @param name - Prompt name
     * @param args - Prompt arguments
     * @param options - Optional call options with auth context
     * @returns Prompt content with messages
     */
    getPrompt(name: string, args?: Record<string, string>, options?: DirectCallOptions): Promise<GetPromptResult>;
    /**
     * List all available jobs.
     *
     * @param options - Optional call options with auth context
     * @returns Tool call result containing jobs list as JSON text
     */
    listJobs(options?: DirectCallOptions): Promise<CallToolResult>;
    /**
     * Execute a job by name.
     *
     * @param name - Job name
     * @param input - Job input arguments
     * @param options - Optional call options with auth context and background flag
     * @returns Tool call result containing execution result as JSON text
     */
    executeJob(name: string, input?: Record<string, unknown>, options?: DirectCallOptions & {
        background?: boolean;
    }): Promise<CallToolResult>;
    /**
     * Get the status of a job run.
     *
     * @param runId - The run ID returned from executeJob
     * @param options - Optional call options with auth context
     * @returns Tool call result containing job status as JSON text
     */
    getJobStatus(runId: string, options?: DirectCallOptions): Promise<CallToolResult>;
    /**
     * List all available workflows.
     *
     * @param options - Optional call options with auth context
     * @returns Tool call result containing workflows list as JSON text
     */
    listWorkflows(options?: DirectCallOptions): Promise<CallToolResult>;
    /**
     * Execute a workflow by name.
     *
     * @param name - Workflow name
     * @param input - Workflow input arguments
     * @param options - Optional call options with auth context and background flag
     * @returns Tool call result containing execution result as JSON text
     */
    executeWorkflow(name: string, input?: Record<string, unknown>, options?: DirectCallOptions & {
        background?: boolean;
    }): Promise<CallToolResult>;
    /**
     * Get the status of a workflow run.
     *
     * @param runId - The run ID returned from executeWorkflow
     * @param options - Optional call options with auth context
     * @returns Tool call result containing workflow status as JSON text
     */
    getWorkflowStatus(runId: string, options?: DirectCallOptions): Promise<CallToolResult>;
    /**
     * Connect a new MCP client to this server.
     * Each client gets its own session and in-memory transport.
     *
     * @param sessionIdOrOptions - Session ID string (shorthand) or full ConnectOptions
     * @returns Connected DirectClient instance
     */
    connect(sessionIdOrOptions?: string | ConnectOptions): Promise<DirectClient>;
    /**
     * Dispose the server and cleanup resources.
     */
    dispose(): Promise<void>;
}
//# sourceMappingURL=direct.types.d.ts.map