@ar-agents/gde-tad

@ar-agents/gde-tad

TAD (Trámites a Distancia) + GDE (Gestión Documental Electrónica) primitives for the Vercel AI SDK. The 4th pieza for sociedades-IA — RFC-001 § 3.4.

What this is

Trámites a Distancia is the AR national portal where citizens and businesses file federal-government forms — IGJ inscriptions, AFIP padron updates, ministry-level authorizations, etc.

GDE (Gestión Documental Electrónica) is the back-office system that holds the resulting expediente. From an agent's POV the relevant surfaces are:

• Domicilio Electrónico Constituido (DEC) — every legally-registered AR business has a DEC. Notifications from any federal organism (ARCA, IGJ, AFIP, Aduana, Trabajo, ANSES) are delivered here.
• Mis Trámites — read-only listing of all expedientes the authenticated identity is a party to.
• Pre-flight schemas — local validation of IGJ inscription payloads, catching the ~30% of rejections that are mechanical.

What this is NOT (yet)

Write-side operations (filing trámites programmatically) are intentionally NOT exposed yet. The legal liability surface is too large until RFC-001 § 3.4 lands. This package is the moat: nobody else has even shipped this much.

Install

pnpm add @ar-agents/gde-tad

Quick start

import { Experimental_Agent as Agent } from "ai";
import { gdeTadTools } from "@ar-agents/gde-tad";

const agent = new Agent({
  model: "anthropic/claude-sonnet-4.5",
  tools: { ...gdeTadTools() },
});

await agent.generate({
  prompt:
    "Validá esta inscripción IGJ antes de mandarla: SAS llamada 'ACME-AI', " +
    "sede en Florida 100 CABA C1005AAA, capital 200000, objeto 'desarrollo " +
    "de software propio', un constituyente con CUIT 20-12345678-9 que aporta 200000.",
});

The validate_igj_inscription tool runs locally — no network, no auth. It catches:

• Reserved words in the denominación (e.g., "Nacional", "Estatal")
• Capital below the legal minimum for the chosen tipo societario
• Aportes that don't sum to the capital social
• Malformed CUITs
• Missing sede fields
• Genérico-style objetos that IGJ rejects

Reading the DEC inbox

When you have a TAD-issued cert + the appropriate per-organism contract:

import { gdeTadTools } from "@ar-agents/gde-tad";
import { MyDomicilioAdapter, MyTramitesAdapter } from "./my-adapters";

const tools = gdeTadTools({
  domicilio: new MyDomicilioAdapter({ cert, key }),
  tramites: new MyTramitesAdapter({ cert, key }),
});

await agent.generate({
  prompt: "Cuáles son las notificaciones críticas que necesito responder esta semana?",
});

Built-in computeSeverity heuristic flags:

• critical — intimaciones, baja de inscripción, clausura, multa, sanción, audiencia, traslado
• important — resoluciones, providencias, vencimientos próximos
• info — acuse de recibo, notificaciones de cortesía, circulares

Testing

import { MockDomicilioAdapter, mockCriticalIntimacionArca } from "@ar-agents/gde-tad/testing";
import { gdeTadTools } from "@ar-agents/gde-tad";

const domicilio = new MockDomicilioAdapter().seedNotifications("20111111119", [
  mockCriticalIntimacionArca(),
]);

const tools = gdeTadTools({ domicilio });

RFC-001 reference

Full pieza-4 governance plan in RFC-001 § 3.4.

License

MIT © Nazareno Clemente