Intramedial está en beta restringida. Al registrarte o iniciar sesión, debes indicar la contraseña de beta tester que recibiste o solicitar una en preview@intramedial.com. Gracias.
Cargando…
rehoming.planMódulo 52
Módulo de la plataforma
Region rehoming
Planifica dónde deben vivir los registros de coordinación de este workspace, ve exactamente qué se movería y llévalo a otra región cuando tú lo decidas.
rehoming.plan nombra una región de origen y otra de destino para el estado, leases y filas de ledger del workspace. execute copia una instantánea real que la región de destino recoge por su cuenta; la presencia en vivo sigue siendo regional, y un workspace ligado a la UE queda fijado rechazando las llamadas de la región antigua una vez registrado.
Los agentes actúan cuando el plano dice sí, y el registro dice por qué.
Pasa por Intramedial acciones de agentes, hashes de contenido, pruebas de API, DNS, webhooks, llamadas LLM y commits. Obtén un recibo firmado que cualquiera verifica, sin fiarse de nadie.
EstadoInstantánea sin firmar; no consta en el ledger
RehomingSnapshot.signed es siempre false; no hay atestación criptográfica del traslado. plan y execute persisten en el almacén de política y en una clave de configuración, pero ninguno llama al appendEvent del ledger, así que «registrado» significa escrito ahí, no en el ledger de auditoría que usan otros módulos.
Registro
El registro
Qué se registra
from
La región actual del workspace.
to
La región de destino solicitada.
pinDOs
Si las clases de Durable Object se fijan al destino como parte de este traslado.
Si la región de destino es una jurisdicción de la UE, lo que activa la fijación 421 tras la ejecución.
status
planned desde plan, o el estado registrado desde status.
workflowId
Presente cuando execute se ejecuta como un Cloudflare Workflow asíncrono y no en línea.
Mecanismo
Paso a paso
Cómo funciona
Se planifica un traslado
plan con una región de destino to devuelve el from calculado, las clases de Durable Object fijadas y si el destino es de la UE, como objeto plano, no envuelto en una clave plan.
La ejecución captura una instantánea real
execute lee claves vivas del almacén de política, leases, filas de D1 y estado de Durable Objects, incluidas las hojas de ledger sin sellar, y lo escribe en una clave auxiliar compartida CONFIG_KV para el workspace.
El destino recoge, nunca se le empuja
La región de destino aplica la instantánea de forma diferida en su siguiente petición a este workspace, con idempotencia según la marca de tiempo de la propia instantánea.
Una fijación en la UE surte efecto una vez registrada
Una vez registrado un traslado a la UE, toda otra llamada a un módulo ACP desde la región antigua devuelve 421 para este workspace, salvo las rutas propias de rehoming, que siguen accesibles en todas partes para inspección.
Pruébalo
Demo en vivo
Ejecútalo desde esta página
GET/api/v1/acp/rehoming/status
// Sin cuerpo: esto es un GET. Pulsa Ejecutar.
Se ejecuta en un workspace de demostración compartido con una clave de demostración: cualquiera puede ver lo que contiene, así que no envíes nada privado. Docs de rehoming.plan
Respuestas
Pulsa Ejecutar para enviar la solicitud de la izquierda al workspace de demostración compartido.
Se ejecuta en un workspace de demostración compartido con una clave de demostración: cualquiera puede ver lo que contiene, así que no envíes nada privado.
Código
Ejemplo en vivo
Una petición real
Una petición con la forma que acepta la API y una respuesta de ejemplo con la forma que devuelve el módulo.
api.intramedial.com/api/v1/acp/rehoming/planPOST
POST/api/v1/acp/rehoming/planAuthorization: Bearer av_workspace_••••Content-Type: application/json
{
"to": "weur"
}
→ 200 { from, to, pinDOs, doClasses, targetWorker, euBound, status, workflowId, llm } (flat; the { plan } wrapper is what rehoming.status returns, not rehoming.plan)
Un workspace planifica un traslado a weur, lo ejecuta, y desde entonces toda llamada desde su región antigua se rechaza con 421 en lugar de servir datos obsoletos en silencio.
Ejecutar la captura en línea
Pasar forceInline: true ejecuta la captura y persistencia de la instantánea de forma síncrona en lugar de pasarla a un Workflow, útil cuando un workspace pequeño no necesita la vía asíncrona.
Mantener las sesiones en vivo donde están
Un workspace que cambia de región mantiene sus websockets de PresenceHub en vivo conectados a la región de origen; en la instantánea viajan solo las últimas filas de presencia conocidas, no las conexiones abiertas.
Repetir status desde cualquier región
Un operador consulta status desde la región en la que trabaje, ya que las rutas propias de rehoming siguen accesibles incluso después de que surta efecto una fijación en la UE.
Cuándo usar otra cosa
Un traslado atómico y destructivo. La ejecución copia una instantánea y deja que el destino la recoja; en ese momento no se borra nada del origen.
Un traslado atestado criptográficamente. El campo signed de la instantánea es siempre false; no hay firma sobre lo que se movió.
Un registro del traslado en el ledger de auditoría. Plan y execute escriben en el almacén de política y en una clave de configuración, nunca en el ledger de coordinación que lee ledger.blame.
Evidencia
Garantías
Qué hace y qué no hace
Un módulo es una afirmación fuerte sobre algo acotado. Confía en él exactamente para lo que es.
Hace
Un workspace ligado a la UE, una vez registrado su traslado, rechaza con 421 toda llamada ACP que no sea de rehoming desde cualquier otra región de producción.
Una instantánea capturada incluye claves vivas del almacén de política, leases, filas de D1 y estado de Durable Objects, no solo una etiqueta de región.
Las conexiones de PresenceHub en vivo nunca se migran; solo se copian a la instantánea sus últimas filas conocidas.
No hace
Que el traslado esté firmado criptográficamente. signed es siempre false en la instantánea que escribe el módulo.
Que el traslado se escriba en el ledger que usan otros módulos. Se registra en el almacén de política y en una clave de configuración, no mediante appendEvent.
Que execute dependa de una confirmación humana. A diferencia de la vía de restauración de remediation.blast, rehoming no tiene un paso de confirmación aparte antes de ejecutar.
Detalles
Notas de construcción
Antes de construir
La forma de plan es plana
La respuesta de la acción plan no está envuelta en una clave plan; ese envoltorio solo aparece en la acción status aparte, que devuelve { plan: stored }.
Se mueven veintidós rutas de política
Una captura recorre una lista fija de rutas del almacén de política junto con leases, filas de D1 y estado de Durable Objects; no se captura nada fuera de esa lista.
El modo desarrollo está exento de la fijación
La fijación 421 de la UE solo se aplica cuando ITML_REGION es una región de producción en vivo; la región de desarrollo local está exenta para poder seguir trabajando en un workspace en local tras un traslado planificado.
Límites y medición
execute escribe una instantánea sin firmar; no hay atestación del traslado que verificar después.
El traslado no se escribe en el ledger de coordinación; ledger.blame no lo mostrará.
No hay acción restore; el ciclo de vida es exactamente plan, execute y status.
Acceso
API y MCP
REST y MCP
Autentícate con una clave de API del workspace como token Bearer. La URL base es https://api.intramedial.com.
Endpoints REST
POST/api/v1/acp/rehoming/planPlanifica un traslado de región y ve qué cubre.
POST/api/v1/acp/rehoming/executeCaptura y persiste la instantánea para que la recoja la región de destino.
GET/api/v1/acp/rehoming/statusLee el plan registrado y su estado.
Acciones MCP
MCPcoordination.rehoming.planPlanifica un traslado como acción MCP.
MCPcoordination.rehoming.executeEjecuta un traslado planificado como acción MCP.
MCPcoordination.rehoming.statusLee el estado de rehoming como acción MCP.
Inspecciona lo que recuerda un agente y toma una instantánea firmada, con raíz Merkle, de su memoria, con un almacén versionado y acotado al workspace.
Módulo de la plataforma
