Auditar una sociedad-IA argentina, en una hoja.

Toda sociedad-IA que use ar-agents escribe cada acción en un registro append-only, firmado al momento de la escritura con HMAC-SHA256. El registro es público en lectura (las entradas no contienen secretos; sí contienen lo que pasó). La clave de firma es privada del operador.

Una entrada típica luce así:

{
  "id": "2026-05-11T14:23:01.512Z-a1b2c3d4",
  "sessionId": "demo-public-ar-001",
  "ts": "2026-05-11T14:23:01.512Z",
  "tool": "mercadopago.preapproval.create",
  "governance": "audit-logged",
  "input": { "payerEmail": "comprador@ejemplo.com.ar", "amount": 1500 },
  "output": { "preapprovalId": "abc123" },
  "durationMs": 412,
  "hmac": "sha256:a4b1c8f7..."
}

La especificación normativa de cada campo (lo que MUST/SHOULD/MAY aparecer) está en RFC-004. La implementación de referencia (código TypeScript que cualquiera puede leer) está en /architecture/audit-log.

La firma HMAC permite que un auditor que notiene la clave del operador igual pueda detectar si una entrada fue modificada después de escrita. El operador no puede ir hacia atrás y cambiar "cobré $1500" por "cobré $1.5M": la firma se rompe.

Cómo verificar usted mismo, sin instalar nada:

1. Abra /verify?sessionId=demo-public-ar-001.
2. El servidor recalcula la firma de cada entrada con su clave + le muestra el conteo: total / verified / tampered.
3. Si quiere verificar usted mismo sin confiar en el servidor, descargue las entradas crudas de /api/play/audit/demo-public-ar-001 y aplique el algoritmo de RFC-004 § 3 con la clave pública (v2 asimétrica) o el desafío-respuesta de posesión de clave (v1 simétrica, planificado v1.1).

La verificación es computacionalmente determinística: la misma entrada con la misma clave produce siempre la misma firma. Esto significa que el operador no puede "arreglar" un registro de auditoría posterior sin que se note.

El operador está obligado a producir, ante requerimiento regulatorio:

• JSON completo: /api/play/audit/demo-public-ar-001
• CSV RFC-4180 con BOM (abre limpio en Excel): /api/play/audit/demo-public-ar-001/csv
• Cuenta de verificación: /api/play/audit/demo-public-ar-001?verify=1
• Stream en vivo (Server-Sent Events) para dashboards regulatorios: GET /api/play/audit-stream/demo-public-ar-001

Plazo de respuesta: 1 día hábil desde el requerimiento. Los endpoints son automáticos; no hay intervención manual del operador.

Cada entrada lleva un campo governance con uno de cuatro valores. La asignación de responsabilidad civil (RFC-001 § 4) depende directamente de este campo:

Si una sociedad-IA emite en producción una entrada con governance: "mocked-upstream", está haciendo una admisión pública de que el efecto secundario no ocurrió contra el sistema real. Un regulador que lee el log distingue una operación productiva de un demo solamente por este campo.

• Inventario de sesiones activas durante una ventana temporal.
• Exportación completa de una sesión específica en JSON + CSV.
• Prueba de verificación: el resultado de verificar las firmas + una prueba de posesión de clave (desafío-respuesta sin revelar la clave).
• Narrativa operativa: un resumen legible por humanos de qué hizo la sociedad-IA durante la ventana, generado del log, no del recuerdo del operador. Provisto vía /play + el CSV.

Con orden judicial, el regulador puede compeler adicionalmente la cadena de custodia de la clave de firma (quién la tuvo, dónde la guardó, cuándo la rotó), equivalente a compeler la custodia del sello de un escribano.

Toda sociedad-IA construida con ar-agents publica en /.well-known/agents.json su identificación jurisdiccional + sus capacidades. Por ejemplo, para una sociedad cuyo operador es CUIT XX-XXXXXXXX-X:

{
  "$schema": "https://ar-agents.ar/schemas/agents.v1.json",
  "version": "1.0",
  "issuer": {
    "jurisdiction": "AR",
    "type": "sociedad-ia",
    "operatorCuit": "XX-XXXXXXXX-X",
    "operatorName": "Naza",
    "supervisionRegime": "rfc-001-v1"
  },
  "endpoints": {
    "auditRead":   "https://ar-agents.ar/api/play/audit/{sessionId}",
    "auditVerify": "https://ar-agents.ar/api/play/audit/{sessionId}?verify=1",
    "auditCsv":    "https://ar-agents.ar/api/play/audit/{sessionId}/csv",
    "auditStream": "https://ar-agents.ar/api/play/audit-stream/{sessionId}"
  },
  "rfcConformance": ["rfc-001-v1", "rfc-002-v1", "rfc-003-draft", "rfc-004-draft"]
}

La convención completa de discovery está en RFC-002. La idea: no hay que adivinar dónde están los endpoints de una sociedad-IA. Hay un lugar estándar.

• RFC-001, Marco de responsabilidad civil de tres capas para sociedades-IA.
• RFC-004, Especificación normativa del log operativo. Es el documento técnico que la legislación puede citar.
• /architecture/audit-log: Desarmado técnico del log (código + razonamiento, 11 secciones).
• /architecture/security, Modelo de amenazas, 14 escenarios.
• /play, Demo anotado de 5 pasos: hacer una operación, ver cómo queda en el log, intentar manipularla y ver cómo se detecta.
• /data-room, Cifras en vivo (npm, GitHub, packages, tests). Auto-refresh cada 6 horas.
• /sociedades-ia, Contexto político-jurídico del régimen propuesto (28-abr-2026).

Si querés conversar sobre cómo este stack se usa, sus limitaciones reales, o cómo se cita en un proyecto de ley: 30 minutos por videollamada, sin honorarios, sin agenda comercial. Escribime a clementenaza@gmail.com con la franja horaria que te sirva. El régimen está en debate; el código ya existe; conviene que ambos lados se hablen.

Esta página puede estar equivocada. La implementación puede tener bugs. La especificación puede tener huecos. Si encuentra alguno, abra un issue público en github.com/ar-agents/ar-agents/issues. Toda la conversación es pública; toda corrección queda registrada en el changelog público.

Esta es una página de un proyecto open-source. No es un documento oficial de ningún organismo. El régimen de sociedades-IA fue anunciado el 28 de abril de 2026 por el Ministerio de Desregulación; al momento de esta publicación, no hay aún ley aprobada. Esta infraestructura existe para que la conversación legislativa tenga un referente técnico concreto que mirar.