@elementor/angie-sdk

Implements the Model Context Protocol specification as a TypeScript SDK, enabling bidirectional communication between client applications and the Angie AI assistant through standardized message schemas. The SDK handles protocol negotiation, request/response routing, and capability advertisement using MCP's resource and tool definition patterns, allowing clients to expose capabilities to Angie while receiving AI-driven instructions in return.

Provides TypeScript interfaces and builder patterns for declaring tools that Angie can invoke, including parameter schemas, return types, and execution handlers. The SDK likely uses JSON Schema or similar for parameter validation and type safety, allowing developers to define tools declaratively with automatic schema generation and validation before Angie receives the capability advertisement.

Enables applications to expose resources (documents, pages, settings, etc.) to Angie through MCP's resource protocol, allowing Angie to read and reference application state without direct database access. The SDK handles resource URI schemes, content serialization, and likely implements caching or lazy-loading patterns to efficiently serve large resource collections to the AI without overwhelming context windows.

Implements MCP's asynchronous request-response pattern with built-in timeout handling, error serialization, and retry logic. The SDK manages the message queue, correlates requests with responses using message IDs, and provides structured error handling that converts application exceptions into MCP-compliant error responses, enabling robust communication even with unreliable or slow network conditions.

Handles the setup and lifecycle management of the MCP connection to Angie, including protocol version negotiation, capability advertisement, and graceful shutdown. The SDK likely provides a fluent builder API for configuration, manages the underlying transport (WebSocket, stdio, or HTTP), and handles reconnection logic for transient failures.

Exports comprehensive TypeScript interfaces and type definitions for all MCP protocol messages, tool schemas, resource definitions, and SDK APIs, enabling full IDE autocomplete, compile-time type checking, and inline documentation. The SDK likely uses discriminated unions for message types and generic types for parameterized tool/resource definitions, providing strong type safety throughout the integration.