@dexwox-labs/a2a-server/dist/response-helpers.d.ts

TypeScript server implementation for Google's Agent-to-Agent (A2A) protocol - includes Express/WebSocket handlers, request validation and queue management

/**
 * @module ResponseHelpers
 * @description Helper functions for generating standardized JSON-RPC responses
 */
import { JsonRpcResponse, A2AError, MessagePart, Task } from '@dexwox-labs/a2a-core';
/**
 * Union type of all possible success response types
 *
 * This type represents all the valid response types that can be returned
 * from A2A protocol method handlers.
 *
 * @internal
 */
type SuccessResponseTypes = Task | MessagePart | string | Record<string, unknown>;
/**
 * Builds a successful JSON-RPC response
 *
 * This function creates a properly formatted JSON-RPC 2.0 success response
 * with the provided result data.
 *
 * @param id - The request ID from the original JSON-RPC request
 * @param result - The result data to include in the response
 * @returns A properly formatted JSON-RPC success response
 *
 * @example
 * ```typescript
 * // Create a success response with a task result
 * const response = buildSuccessResponse('request-123', {
 *   id: 'task-456',
 *   state: 'completed',
 *   result: { data: 'Task output' }
 * });
 * ```
 */
export declare function buildSuccessResponse<T extends SuccessResponseTypes>(id: string | number | undefined, result: T): JsonRpcResponse<T>;
/**
 * Builds an error JSON-RPC response
 *
 * This function creates a properly formatted JSON-RPC 2.0 error response
 * with the provided error object.
 *
 * @param id - The request ID from the original JSON-RPC request
 * @param error - The error object to include in the response
 * @returns A properly formatted JSON-RPC error response
 *
 * @example
 * ```typescript
 * // Create an error response
 * const error = new A2AError('Task not found', -32011);
 * const response = buildErrorResponse('request-123', error);
 * ```
 */
export declare function buildErrorResponse(id: string | number | undefined, error: A2AError): JsonRpcResponse<null>;
/**
 * Validates that a response matches one of the expected types
 *
 * This function checks if a response object has a type that matches
 * one of the expected types. For string responses, it checks if 'string'
 * is in the expected types array.
 *
 * @param response - The response object to validate
 * @param expectedTypes - Array of valid type strings
 * @returns True if the response type is valid, false otherwise
 *
 * @example
 * ```typescript
 * // Check if a response is a valid message part
 * const isValid = validateResponseType(
 *   { type: 'text', content: 'Hello' },
 *   ['text', 'image']
 * );
 * ```
 */
export declare function validateResponseType(response: unknown, expectedTypes: string[]): boolean;
/**
 * Prepares a JSON-RPC response with validation
 *
 * This function handles both success and error cases, validating that
 * success responses match the expected types. If validation fails,
 * it automatically generates an appropriate error response.
 *
 * @param id - The request ID from the original JSON-RPC request
 * @param response - The response object or error to include
 * @param expectedTypes - Array of valid response types
 * @returns A properly formatted JSON-RPC response
 *
 * @example
 * ```typescript
 * // Prepare a response with validation
 * const result = await handleRequest();
 * const response = prepareResponse(
 *   'request-123',
 *   result,
 *   ['text', 'image']
 * );
 * ```
 */
export declare function prepareResponse<T extends Exclude<SuccessResponseTypes, string>>(id: string | number | undefined, response: T | A2AError, expectedTypes: string[]): JsonRpcResponse<T>;
export {};
//# sourceMappingURL=response-helpers.d.ts.map