Download the PHP package sunnyface/ai-contracts without Composer
On this page you can find all versions of the php package sunnyface/ai-contracts. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sunnyface/ai-contracts
More information about sunnyface/ai-contracts
Files in sunnyface/ai-contracts
Package ai-contracts
Short Description Contratos DTO y esquemas compartidos entre Hub y Spoke
License
Informations about the package ai-contracts
☀️ Sunnyface AI Contracts
El puente telepático de tipado estricto entre el Hub y el Spoke.
Este paquete proporciona la librería central de Data Transfer Objects (DTOs) y contratos compartidos para el ecosistema de IA de Sunnyface. Diseñado para sincronizar las mentes de los equipos de desarrollo más exigentes del planeta, asegurando que la comunicación en sistemas distribuidos sea impecable, robusta y libre de alucinaciones.
🚀 ¿Por qué este paquete brilla? ✨
Olvídate de los arrays asociativos crudos y de jugar a las adivinanzas. Gracias al poder de PHP 8.4 y spatie/laravel-data v4, este paquete ofrece:
- Cero validación manual en el controlador: Cuando inyectes DTOs como
ExecuteAgentTaskRequesten tu controlador, propiedades complejas como$request->payloadya serán instancias perfectas deConversationalPayloadDTO,VisionExtractorPayloadDTOoDocumentClassifierPayloadDTO. ¡La librería hace el trabajo sucio por ti! - Tipado estricto (Union Types): PHPStan y tu IDE ahora saben exactamente qué métodos y propiedades están disponibles. Se acabó el rezar para que
$payload['message'] ?? nullexista. - Colecciones automáticas: Propiedades como
$prefetched_chat_messagesse hidratan automáticamente en un array de objetos reales (ej.ChatMessageDTO), en lugar de dejarte con arrays anidados genéricos.
¡Es un contrato blindado y digno de presumir! 😎
📦 Instalación
Puedes instalar este paquete vía Composer en cualquier servicio satélite (Spoke) o en el Hub central:
(Asegúrate de tener configurado el acceso al repositorio si es privado).
💻 Uso Real (Nada de ExampleDTO inventados)
Aquí tienes un ejemplo de cómo se ve la magia en un controlador de tu aplicación Laravel:
🛠 Arquitectura y Estructura
El paquete está organizado lógicamente para reflejar el dominio del sistema:
src/Data/Agent/: Configuración específica de los diferentes tipos de agentes (Talker, Extractor, etc.).src/Data/Network/: Envelopes y webhooks que cruzan la frontera de red (Hub ↔ Spoke).src/Data/Spoke/: Payloads y respuestas específicas para la API pública de los satélites.src/Enums/: Enumeraciones compartidas (TaskStatus,MessageRole,HandlerSlug, etc.) para evitar magic strings.
📜 Licencia
Este proyecto es software propietario de Sunnyface. Todos los derechos reservados.
Que el tipado estricto os acompañe en el mundo físico y eléctrico para toda la eternidad. ⚡🤖
All versions of ai-contracts with dependencies
spatie/laravel-data Version ^4.0
illuminate/contracts Version ^12.0|^13.0
illuminate/http Version ^12.0|^13.0
illuminate/support Version ^12.0|^13.0
mallardduck/blade-lucide-icons Version ^1.26