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…
civics.recordsMódulo 48
Módulo de la plataforma
Public records search
Pregunta al registro qué le pasó a un recurso, o lee los eventos del workspace tal cual, redactados según lo que permite tu permiso.
civics.records es una ventana pública fina al ledger: con un resource delega en la misma lógica de blame que ledger.blame, y sin él lista eventos. Quien llama con records.export ve todos los campos; los demás reciben los campos de identificadores de testigo eliminados antes de que la respuesta salga de la plataforma.
Intralock · Leases · Parley · Fleet Map
Un producto Trustvice
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.
Estado«Filtrar cada evento» exagera la superficie real
El único filtro es resource; aquí no hay filtro por actor, tipo ni rango de fechas. Un filtrado más fino debe hacerse en el cliente, o llamando directamente a las acciones ledger.blame/ledger.list con el filtrado que admitan.
Registro
El registro
Qué se registra
resource
El filtro opcional; cuando se da, acota al historial propio de ese recurso.
projection
"records" para la lista sin filtrar, o "blame" cuando se dio un resource.
public u operator, decidido por los permisos de quien llama, nunca por un campo de la petición.
events
Los eventos coincidentes, cada uno con los campos de identificadores de testigo eliminados salvo que quien llama lea en nivel operator.
lastTouch
Con un filtro resource, el toque más reciente, con cualquier campo que el evento nunca registró nombrado en unknown.
why
Con un filtro resource, la regla de coincidencia usada: recurso o sujeto igual al valor dado.
Mecanismo
Paso a paso
Cómo funciona
Se fija el nivel de divulgación de quien llama
Quien llama con el permiso records.export lee en nivel operator; los demás leen en public, decidido antes de obtener nada.
Un recurso acota a su historial
Pasar resource delega en la lógica de blame del ledger y devuelve los eventos de ese recurso en orden cronológico inverso, con lastTouch y cualquier campo unknown nombrado con honestidad.
Sin recurso lista todo
Sin resource, todos los eventos del ledger del workspace vuelven como events, con el mismo nivel de divulgación.
Se eliminan los identificadores, no el contenido
En nivel public, campos como rootHex, otsDigestHex e inclusionProof se eliminan de cada evento y su cuerpo; nada más del evento se altera.
Pruébalo
Demo en vivo
Ejecútalo desde esta página
GET/api/v1/acp/civics/records
// 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 civics.records
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/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 miembro sin derechos de exportación lee lo que pasó con un recurso con los campos de identificadores de testigo eliminados, suficiente para ver la forma de los eventos sin exponer el material de prueba.
Un operador que extrae el registro completo
Un propietario del workspace con records.export lee los mismos eventos en nivel operator, sin quitar nada, para una exportación de cumplimiento.
Rastrear el historial de un recurso
Pasar resource convierte el registro general en una vista de blame enfocada, la misma que devuelve el propio ledger.blame.
Saber lo que el registro no sabe
Un lastTouch al que le falta el actor o la resolución lo dice en unknown, en lugar de adivinar o dejar el campo ausente en silencio.
Cuándo usar otra cosa
Filtrar por actor, tipo o rango de fechas. Aquí solo resource acota el resultado.
Cambiar o eliminar un evento escrito. No existe acción de actualizar ni borrar; el registro solo crece.
Leer los eventos de otro workspace. Toda lectura se limita al propio workspace de quien llama.
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
El nivel de divulgación se calcula a partir de los permisos de quien llama, nunca se acepta como un campo de la petición que pudiera fijar él mismo.
La transcripción confirmada y con hash de un evento nunca se altera a posteriori, aunque se pueda adjuntar más tarde una prueba de testigo a su fila guardada.
Ninguna acción de este módulo, ni del ledger del que lee, puede actualizar ni borrar un evento escrito.
No hace
Que todo evento que tocó un recurso se pueda filtrar por algo más allá de su cadena exacta de resource o subject.
Que un lector público y uno operador vean eventos distintos, solo campos distintos de los mismos eventos.
Que la cabecera del gateway que lleva el permiso de quien llama no pueda estar mal configurada; este módulo se fía de lo que recibe.
Detalles
Notas de construcción
Antes de construir
Delega en el módulo del ledger
Tanto la ruta de blame como la de lista llaman directamente a las propias funciones de ledger.blame y ledger.list; civics.records añade encima la capa de redacción por permisos, no un almacén aparte.
Los identificadores de testigo, con nombre
Los campos eliminados en nivel public son leafHex, rootHex, otsDigestHex, entpoindReceiptId, topsEntryId, witnessRecordId, awsWitnessKey, awsKmsKeyId, awsCountersignHex e inclusionProof.
No existe acción MCP
civics.records es accesible solo por REST; civics.presence, civics.forum, civics.claims y civics.list tienen cada uno su propia acción MCP, pero records no.
Límites y medición
El único filtro es resource; no hay actor, tipo ni rango de fechas.
El nivel de divulgación es binario: public u operator, decidido por un solo permiso, no una escala gradual.
No existe id de acción MCP ni de contrato para esta ruta; llámala por REST.
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
GET/api/v1/acp/civics/recordsLee eventos tal cual, o el historial de un recurso con resource.
Acciones MCP
Este módulo no tiene acción MCP. Llámalo por REST desde cualquier agente o programa.
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.
Módulo de la plataforma
