/** * Agent Spec Runtime Endpoint Configuration * * Defines the API endpoints for connecting to Agent Spec runtimes * (WayFlow, PyAgentSpec, or other compatible runtimes). */ /** * Agent Spec runtime endpoint configuration. * * Separate from the main FlowDrop EndpointConfig because the Agent Spec * runtime is an independent service with its own base URL and auth. * * @example * ```typescript * const config: AgentSpecEndpointConfig = { * baseUrl: 'http://localhost:8000', * endpoints: { ...defaultAgentSpecEndpoints.endpoints }, * auth: { type: 'bearer', token: 'my-api-key' } * }; * ``` */ export interface AgentSpecEndpointConfig { /** Base URL for the Agent Spec runtime */ baseUrl: string; endpoints: { /** POST — Execute a flow (body: AgentSpecFlow JSON) */ execute: string; /** GET — Get execution status (params: {id}) */ status: string; /** POST — Cancel a running execution (params: {id}) */ cancel: string; /** GET — Get execution results (params: {id}) */ results: string; /** WS — WebSocket for streaming execution updates (params: {id}) */ stream: string; /** POST — Validate a flow specification (body: AgentSpecFlow JSON) */ validate: string; /** GET — List available agents on the runtime */ agents: string; /** GET — List available tools on the runtime */ tools: string; /** GET — Runtime health check */ health: string; }; /** Authentication for the runtime */ auth?: { type: 'none' | 'bearer' | 'api_key'; token?: string; apiKey?: string; }; /** Request timeout in milliseconds */ timeout?: number; } /** * Default Agent Spec runtime endpoints. * Targets a local WayFlow/PyAgentSpec instance on port 8000. */ export declare const defaultAgentSpecEndpoints: AgentSpecEndpointConfig; /** * Create Agent Spec endpoint configuration with custom base URL. */ export declare function createAgentSpecEndpointConfig(baseUrl: string, overrides?: Partial): AgentSpecEndpointConfig; /** * Build a full URL for an Agent Spec runtime endpoint. */ export declare function buildAgentSpecUrl(config: AgentSpecEndpointConfig, endpointPath: string, params?: Record): string; /** * Get authentication headers for Agent Spec runtime requests. */ export declare function getAgentSpecAuthHeaders(config: AgentSpecEndpointConfig): Record;