@mcp-sextoy/types
v0.6.2
Published
Shared type definitions, Zod schemas, and interfaces for the universal MCP hardware orchestrator. This package serves as the **contractual source of truth** between the central Core and all pluggable hardware modules (Plugins).
Readme
@mcp-sextoy/types
Shared type definitions, Zod schemas, and interfaces for the universal MCP hardware orchestrator. This package serves as the contractual source of truth between the central Core and all pluggable hardware modules (Plugins).
Purpose
By centralizing all types and validation schemas, this package ensures that any community-developed plugin will be compatible with the Core orchestration logic, including safety-rails and discovery protocols.
Key Components
📐 HardwareProfile
Defines the metadata and capabilities of a physical device.
modelId: String used for auto-discovery and tool scoping.safety: Configuration for Anti-Jolt (maxJump) and local limits.features: Mapping of motor indices to types (Vibrate, Constrict, etc.).tools: Array of MCP-exposed tool definitions with custom handlers.
🕒 DevicePattern
The schema for time-series hardware sequences.
- Supports multi-track patterns.
- Includes duration, power levels, and transition curves.
🛠️ ToolExecutionContext
The environment provided to a plugin's tool handler during execution.
device: The native device instance.engine: Access to controlled safety methods (vibrate, constrict).signal: An AbortSignal to handle user-initiated stops.
Installation
npm install @mcp-sextoy/typesLicense
GPL-3.0