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…
civics.recordsModule 48
Module du plan
Public records search
Demandez au registre ce qui est arrivé à une ressource, ou lisez simplement les événements de l'espace de travail, expurgés selon vos permissions réelles.
civics.records est une fenêtre publique fine sur le registre : avec un resource, elle délègue à la même logique de blame que ledger.blame ; sans, elle liste les événements. Un appelant avec records.export voit tous les champs ; les autres reçoivent les champs de témoin retirés avant que la réponse ne quitte le plan.
Intralock · Baux · Parley · Fleet Map
A Trustvice Product
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.
État« Filtrer chaque événement » surestime la surface réelle
Le seul filtre est resource ; il n'y a ni filtre par acteur, type ou plage de dates. Un filtrage plus fin doit se faire côté client, ou en appelant directement les actions sous-jacentes ledger.blame/ledger.list avec le filtrage qu'elles supportent.
Registre
Le registre
Ce qui est enregistré
resource
Le filtre facultatif ; s'il est fourni, restreint à l'historique propre de cette ressource.
projection
"records" pour la liste non filtrée, ou "blame" quand un resource est fourni.
public ou operator, décidé d'après les permissions de l'appelant, jamais d'après un champ de la requête.
events
Les événements correspondants, chacun avec les champs de témoin retirés sauf si l'appelant lit au niveau operator.
lastTouch
Avec un filtre resource, la plus récente intervention sur celle-ci, les champs jamais enregistrés par l'événement étant nommés dans unknown.
why
Avec un filtre resource, la règle de correspondance utilisée : ressource ou sujet égal à la valeur donnée.
Mécanisme
Pas à pas
Comment ça marche
Le niveau de divulgation de l'appelant est fixé
Un appelant avec la permission records.export lit au niveau operator ; les autres lisent au niveau public, décidé avant toute récupération.
Une ressource restreint à son historique
Passer resource délègue à la logique blame du registre et renvoie les événements de cette ressource en ordre antéchronologique, avec lastTouch et les champs unknown nommés honnêtement.
Sans ressource, tout est listé
Sans resource, tous les événements du registre de l'espace de travail reviennent dans events, au même niveau de divulgation.
Handles retirés, pas le contenu
Au niveau public, des champs comme rootHex, otsDigestHex et inclusionProof sont retirés de chaque événement et de son corps ; rien d'autre n'est modifié.
Essayer
Démo en direct
Exécutez-le depuis cette page
GET/api/v1/acp/civics/records
// 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 civics.records
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/civics/recordsGET
GET/api/v1/acp/civics/recordsAuthorization: Bearer av_workspace_••••→ 200 { projection, disclosureLevel, events } (filtering by resource also adds lastTouch, unknown and why)
Un membre sans droit d'export lit ce qui est arrivé à une ressource, champs de témoin retirés : assez pour voir la forme des événements sans exposer les preuves.
Un opérateur qui récupère le registre complet
Le propriétaire d'un espace de travail avec records.export lit les mêmes événements au niveau operator, sans rien retirer, pour un export de conformité.
Retracer l'historique d'une ressource
Passer resource transforme le registre général en vue blame ciblée, la même que celle renvoyée par ledger.blame.
Savoir ce que le registre ignore
Un lastTouch dont l'acteur ou la décision manque le dit dans unknown, plutôt que de deviner ou d'omettre silencieusement le champ.
Quand utiliser autre chose
Filtrer par acteur, type ou plage de dates. Seul resource restreint le résultat ici.
Modifier ou supprimer un événement écrit. Aucune action de mise à jour ou de suppression n'existe ; le registre ne fait que croître.
Lire les événements d'un autre espace de travail. Chaque lecture est limitée à l'espace de travail de l'appelant.
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
Le niveau de divulgation est calculé d'après les permissions de l'appelant, jamais accepté comme champ de requête que l'appelant pourrait fixer lui-même.
La transcription validée et hachée d'un événement n'est jamais modifiée après coup, même si une preuve de témoin peut être attachée plus tard à sa ligne stockée.
Aucune action de ce module, ni du registre qu'il lit, ne peut mettre à jour ou supprimer un événement écrit.
Il ne le fait pas
Que tout événement touchant une ressource soit filtrable autrement que par sa chaîne exacte resource ou subject.
Qu'un lecteur public et un lecteur opérateur voient des événements différents : seuls les champs diffèrent sur les mêmes événements.
Que l'en-tête de passerelle portant la permission de l'appelant ne puisse pas être mal configuré ; ce module fait confiance à ce qu'on lui remet.
Détails
Notes de conception
Avant de construire
Délègue au module du registre
Les chemins blame et liste appellent directement les propres fonctions de ledger.blame et ledger.list ; civics.records ajoute la couche d'expurgation par permission, pas un stockage distinct.
Handles de témoin, nommés
Les champs retirés au niveau public sont leafHex, rootHex, otsDigestHex, entpoindReceiptId, topsEntryId, witnessRecordId, awsWitnessKey, awsKmsKeyId, awsCountersignHex et inclusionProof.
Aucune action MCP
civics.records n'est accessible que via REST ; civics.presence, civics.forum, civics.claims et civics.list ont chacune leur action MCP, mais pas records.
Limites et mesure
Le seul filtre est resource ; ni acteur, ni type, ni plage de dates.
Le niveau de divulgation est binaire : public ou operator, décidé par une seule permission, sans gradation.
Aucun identifiant d'action MCP ou de contrat n'existe pour cette route ; appelez-la via REST.
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
GET/api/v1/acp/civics/recordsLire les événements simplement, ou l'historique d'une ressource avec resource.
Actions MCP
Ce module n’a aucune action MCP. Appelez-le via REST depuis n’importe quel agent ou programme.
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.
Module du plan
