Fundamentos Técnicos

Conceptos Básicos

Asset Core es un motor espacial-transaccional determinista que trata el estado del mundo como una serie de transformaciones atómicas y reproducibles. Cuando los agentes basados en LLM ejecutan llamadas a herramientas—desde agregar elementos a un contenedor hasta mover entidades a través de una cuadrícula—cada mutación se registra en un registro de confirmación de solo anexado que sirve como la única fuente de verdad.

Esta arquitectura garantiza que:

• La misma secuencia de eventos siempre produce el mismo estado final (determinismo)
• Cualquier punto en el tiempo puede ser reconstruido reproduciendo el registro de confirmaciones (replay)
• El estado interno y las notificaciones externas nunca divergen (consistencia)
• Todas las operaciones son atómicas y transaccionales (fiabilidad)

Tipos de Contenedores

Los agentes operan en entornos con diferentes estructuras espaciales. Asset Core proporciona tipos de contenedores de primera clase para cada uno, modelando los contenedores como objetos tipados espacialmente donde cada uno representa un tipo distinto de espacio direccionable. El sistema actualmente admite:

Contenedores 0-Dimensionales

• Balances: Agregados escalares sin coordenadas espaciales. Utilizados para moneda, recursos o cualquier cantidad que no ocupe espacio.
• Slots: Posiciones discretas y numeradas (1, 2, …, N) sin relaciones geométricas. Se utilizan para espacios de equipo, listas ordenadas o posiciones semánticas.

Redes Discretas (1D/2D)

• 1D Grids (ℤ): Redes lineales con posiciones secuenciales. Soportan la colocación de formas, colisiones y restricciones espaciales a lo largo de un solo eje.
• Rejillas 2D (ℤ²): Redes bidimensionales (ancho × alto) con semántica geométrica completa. Soporta formas de múltiples celdas, rotación, adyacencia y detección de colisiones.

Espacios Continuos (1D/2D)

• 1D Continuo (ℝ): Coordenadas de punto fijo a lo largo de una línea para rieles, ascensores y robótica de un solo eje.
• 2D Continuo (ℝ²): Colocaciones fijas de puntos x/y con rotación para celdas de trabajo de robots y verificaciones de colisión métricas.

Hoja de ruta: Dimensiones Superiores

Rejillas Discretas 3D (ℤ³): Redes volumétricas con profundidad, extendiendo la semántica 2D a tres dimensiones.

3D continuo (ℝ³): Volúmenes continuos con integración de física, colisión basada en métricas y transformaciones suaves.

Operaciones Universales

Todos los contenedores comparten un conjunto común de operaciones que funcionan de manera consistente a través de espacios dimensionales:

• Agregar/Eliminar: Introducir o eliminar cantidades o entidades
• Mover: Traducir entidades dentro del mismo espacio de contenedor
• Dividir/Combinar: Divide o combina pilas y cantidades
• Transferencia: Mover entidades entre diferentes contenedores (transiciones entre espacios)

Estas operaciones preservan el determinismo, son completamente reproducibles y mantienen una semántica consistente, ya sea que se apliquen a saldos 0D o a cuadrículas 2D.

Arquitectura

Cuando un agente ejecuta una llamada a una herramienta que modifica el estado del mundo, Asset Core la procesa a través de tres capas. Esta arquitectura de tres capas está inspirada en los motores de almacenamiento de bases de datos, asegurando una clara separación de preocupaciones y un comportamiento predecible.

Capa de Almacenamiento (L1)

Estructuras de datos de bajo nivel optimizadas para el rendimiento. Utiliza un diseño de Estructura de Arreglos (SoA) con IDs densos para una iteración amigable con la caché y patrones de acceso a la memoria predecibles. Esta capa proporciona primitivas en bruto sin validación ni lógica de negocio.

Capa de Operaciones (L2)

Validación de dominio y orquestación de estado. Esta capa orquesta primitivas de almacenamiento, impone restricciones del mundo (colisión, límites, ajuste de forma), mantiene índices derivados y emite eventos que describen lo que ha cambiado. Las operaciones son deterministas y están completamente validadas antes de ser confirmadas.

Capa de Transacción (L3)

Ejecución atómica con soporte para retroceso. Esta capa coordina los límites de las transacciones, registra información de deshacer para el retroceso y sella las operaciones exitosas en el registro de confirmación. Garantiza que las operaciones sean atómicas e aisladas. Este apilamiento asegura que los caminos críticos para el rendimiento permanezcan rápidos (L1), las reglas del mundo estén centralizadas y sean verificables (L2), y la corrección transaccional se haga cumplir estructuralmente (L3).

Garantías

Asset Core proporciona fuertes garantías de corrección y fiabilidad a través de la reproducción determinista y un registro de confirmaciones de solo anexado.

Repetir

La reproducción es central para las garantías de corrección de Asset Core y permite la reconstrucción perfecta del comportamiento del agente. El registro de confirmaciones almacena eventos como registros híbridos que contienen tanto:

• Información de delta: Qué cambió (se añadieron 10 elementos, se movió de la ranura A a la ranura B)
• Estado posterior: El estado resultante después del cambio (la cantidad final es 50, la entidad ahora está en la posición X)

Esta codificación dual permite:

• Análisis en tiempo real: La información delta puede impulsar paneles de control, notificaciones y consultas en vivo.
• Reproducción determinista: El estado posterior define el resultado autoritativo; reproducir la secuencia grabada reproduce el estado original exacto sin deriva acumulativa.
• Recuperación de fallos: Cualquier proyección (modelo de lectura u observador) puede ser reconstruida a partir del registro de confirmaciones.

La reproducción aplica eventos mecánicamente utilizando solo primitivas de almacenamiento, sin validación ni lógica de reglas del mundo. Esto garantiza que el estado reproducido sea equivalente bit a bit al estado original comprometido.

Registro de Commits

El registro de commits es una secuencia durable de lotes de eventos sellados que solo se puede agregar, y que sirve como el registro autoritativo de todas las acciones de los agentes. Evita escrituras duales al hacer del registro la única escritura atómica: cada transición de estado es sellada por un único agregado, y todas las proyecciones y notificaciones derivan de esa única fuente de verdad.

Propiedades clave:

• Los eventos son inmutables una vez comprometidos.
• Los números de secuencia globales, que aumentan monotonamente, proporcionan un orden total.
• Los lotes son verificados mediante suma de comprobación para la verificación de integridad.
• Los segmentos pueden ser comprimidos, cifrados o archivados.

Este diseño admite el cumplimiento (rutas de auditoría, cadena de custodia), la depuración (reproducción a cualquier estado histórico) y el aislamiento multi-inquilino (historial de confirmaciones con espacio de nombres). Las proyecciones y notificaciones se derivan de eventos confirmados y pueden ser reintentadas de forma independiente sin arriesgar la divergencia.

Casos de Uso

Asset Core está diseñado para soportar sistemas que requieren un modelo determinista y transaccional del estado del mundo, con un enfoque principal en agentes basados en LLM y plataformas multiagente.

Sistemas Multi-Agente

En entornos de múltiples agentes, Asset Core puede servir como el modelo de mundo compartido. Las invocaciones de herramientas registran cambios de estado deterministas—como mover o transferir recursos—en el registro de confirmaciones, creando una línea de tiempo auditable para depuración, análisis y reproducción.

Plataformas de Agentes y Orquestación

Los marcos de orquestación pueden integrar Asset Core para proporcionar un estado de sesión duradero y aislamiento con espacio de nombres. La reproducción determinista permite flujos de trabajo de múltiples pasos reproducibles e inspección post-hoc.

Simulaciones y Juegos

Los motores de simulación y juego pueden emplear Asset Core para modelar inventarios, equipos y lógica espacial. La reproducción determinista admite un comportamiento preciso de guardar/cargar, estado multijugador sincronizado y verificación de grado de auditoría.

Ver Ejemplos

Para demostraciones concretas de cada tipo de contenedor, consulte la página de Ejemplos para operaciones JSON ejecutables en espíritu y escenarios de agentes.