Intramedial est en bêta restreinte. À l’inscription ou à la connexion, vous devez fournir le mot de passe de bêta-testeur que vous avez reçu ou en demander un à preview@intramedial.com. Merci.
Chargement…
rehoming.planModule 52
Module du plan
Region rehoming
Planifiez où doivent vivre les registres de coordination de cet espace de travail, voyez exactement ce qui serait déplacé, puis transférez-le vers une autre région quand vous le décidez.
rehoming.plan nomme une région source et cible pour l'état, les leases et les lignes de registre de l'espace de travail. execute copie un vrai instantané que la région cible récupère d'elle-même ; la présence active reste régionale, et un espace de travail lié à l'UE est épinglé en refusant les appels de l'ancienne région une fois enregistré.
Les agents agissent quand le plan dit oui, et le registre dit pourquoi.
Faites passer actions d’agents, hash de contenu, contrôles d’API, requêtes DNS, webhooks, appels LLM et commits git par Intramedial. Obtenez un reçu signé vérifiable par tous – sans nous croire.
ÉtatInstantané non signé ; non inscrit au registre
RehomingSnapshot.signed vaut toujours false ; il n'y a aucune attestation cryptographique du transfert. plan et execute persistent dans le stockage de politiques et une clé de configuration, mais aucun n'appelle appendEvent du registre : « enregistré » signifie écrit là, pas dans le registre d'audit utilisé par les autres modules.
Registre
Le registre
Ce qui est enregistré
from
La région actuelle de l'espace de travail.
to
La région cible demandée.
pinDOs
Si les classes Durable Object sont épinglées à la cible dans ce déplacement.
Si la région cible relève d'une juridiction UE, ce qui déclenche l'épinglage 421 après exécution.
status
planned depuis plan, ou l'état enregistré depuis status.
workflowId
Défini quand execute s'exécute comme Cloudflare Workflow asynchrone plutôt qu'en ligne.
Mécanisme
Pas à pas
Comment ça marche
Un déplacement est planifié
plan avec une région cible to renvoie from calculé, les classes Durable Object épinglées et si la cible est liée à l'UE, sous forme d'objet plat, pas enveloppé dans une clé plan.
L'exécution capture un vrai instantané
execute lit les clés actives du stockage de politiques, les leases, les lignes D1 et l'état des Durable Objects, y compris les feuilles de registre non scellées, et l'écrit dans une clé annexe CONFIG_KV partagée pour l'espace de travail.
La cible récupère, jamais poussée
La région cible applique l'instantané paresseusement à sa prochaine requête propre pour cet espace de travail, de façon idempotente, indexée par l'horodatage de l'instantané.
Un épinglage UE prend effet une fois enregistré
Une fois un déplacement lié à l'UE enregistré, tout autre appel de module ACP depuis l'ancienne région renvoie 421 pour cet espace de travail, sauf les routes propres au rehoming, qui restent accessibles partout pour inspection.
Essayer
Démo en direct
Exécutez-le depuis cette page
GET/api/v1/acp/rehoming/status
// Pas de corps : c’est un GET. Appuyez sur Exécuter.
S’exécute dans un workspace de démonstration partagé avec une clé de démonstration : tout le monde peut voir ce qu’il contient, n’envoyez donc rien de privé. Docs rehoming.plan
Réponses
Appuyez sur Exécuter pour envoyer la requête de gauche au workspace de démonstration partagé.
S’exécute dans un workspace de démonstration partagé avec une clé de démonstration : tout le monde peut voir ce qu’il contient, n’envoyez donc rien de privé.
Code
Exemple en direct
Une vraie requête
Une requête dans la forme acceptée par l’API, et un exemple de réponse dans la forme renvoyée par le module.
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 espace de travail planifie un déplacement vers weur, l'exécute, et dès lors tout appel depuis son ancienne région est refusé avec 421 plutôt que de servir silencieusement des données périmées.
Exécuter la capture en ligne
Passer forceInline: true exécute la capture et la persistance de l'instantané de façon synchrone au lieu de les confier à un Workflow, utile quand un petit espace de travail n'a pas besoin du chemin asynchrone.
Garder les sessions actives où elles sont
Un espace de travail qui change de région garde ses websockets PresenceHub actives connectées à la région source ; seules les dernières lignes de présence connues voyagent dans l'instantané, pas les connexions ouvertes elles-mêmes.
Relire le statut depuis n'importe quelle région
Un opérateur consulte status depuis la région où il travaille, puisque les routes propres au rehoming restent accessibles même après la prise d'effet d'un épinglage UE.
Quand utiliser autre chose
Un déplacement atomique et destructif. L'exécution copie un instantané et laisse la cible le récupérer ; rien n'est supprimé de la source à ce moment.
Un transfert attesté cryptographiquement. Le champ signed de l'instantané vaut toujours false ; il n'y a pas de signature sur ce qui a été déplacé.
Un enregistrement du déplacement dans le registre d'audit. Plan et execute écrivent dans le stockage de politiques et une clé de configuration, jamais dans le registre de coordination que lit ledger.blame.
Preuves
Garanties
Ce qu’il fait, et ce qu’il ne fait pas
Un module est une affirmation forte sur un sujet étroit. Fiez-vous-y exactement pour ce qu’il est.
Il le fait
Un espace de travail lié à l'UE, une fois son déplacement enregistré, refuse tout appel ACP hors rehoming depuis toute autre région de production avec 421.
Un instantané capturé inclut les clés actives du stockage de politiques, les leases, les lignes D1 et l'état des Durable Objects, pas seulement une étiquette de région.
Les connexions PresenceHub actives ne sont jamais migrées ; seules leurs dernières lignes connues sont copiées dans l'instantané.
Il ne le fait pas
Que le transfert soit signé cryptographiquement. signed vaut toujours false sur l'instantané qu'écrit le module.
Que le déplacement soit écrit dans le registre utilisé par les autres modules. Il est enregistré dans le stockage de politiques et une clé de configuration, pas via appendEvent.
Que execute soit lui-même soumis à une confirmation humaine. Contrairement au chemin de restauration de remediation.blast, le rehoming n'a pas d'étape de confirmation distincte avant l'exécution.
Détails
Notes de conception
Avant de construire
La forme de plan est plate
La réponse de l'action plan n'est pas enveloppée dans une clé plan ; cet enveloppe n'apparaît que dans l'action status distincte, qui renvoie { plan: stored }.
Vingt-deux chemins de politique sont déplacés
Une capture parcourt une liste fixe de chemins du stockage de politiques, ainsi que les leases, les lignes D1 et l'état des Durable Objects ; rien en dehors de cette liste n'est capturé.
Le mode dev est exempté de l'épinglage
L'épinglage UE 421 ne s'applique que lorsque ITML_REGION est une région de production active ; la région de développement locale est exemptée pour qu'un espace de travail reste utilisable en local après un déplacement planifié.
Limites et mesure
execute écrit un instantané non signé ; il n'y a aucune attestation du transfert à vérifier plus tard.
Le déplacement n'est pas écrit dans le registre de coordination ; ledger.blame ne le montrera pas.
Il n'y a pas d'action restore ; le cycle de vie se limite à plan, execute et status.
Accès
API et MCP
REST et MCP
Authentifiez-vous avec une clé d’API d’espace de travail comme jeton Bearer. L’URL de base est https://api.intramedial.com.
Points d’accès REST
POST/api/v1/acp/rehoming/planPlanifier un changement de région et voir ce qu'il couvre.
POST/api/v1/acp/rehoming/executeCapturer et persister l'instantané que la région cible doit récupérer.
GET/api/v1/acp/rehoming/statusLire le plan enregistré et son statut.
Actions MCP
MCPcoordination.rehoming.planPlanifier un déplacement comme action MCP.
MCPcoordination.rehoming.executeExécuter un déplacement planifié comme action MCP.
MCPcoordination.rehoming.statusLire le statut du rehoming comme action MCP.
Inspectez ce dont un agent se souvient et prenez un instantané signé, à racine Merkle, de sa mémoire, avec un stockage versionné et limité à l'espace de travail.
Module du plan
