Lo que operamos

Cuatro tipos de agente, puestos a trabajar en toda su operación — cada uno proponiendo, nunca actuando solo.

Cómo se controla

La diferencia no es un panel vistoso. Es la firma — y nada actúa en su nombre por su cuenta.

Medido, no proclamado

Cómo se sostienen los agentes — no cifras de autonomía inventadas.

La construcción — qué propone, qué controla el paso, qué registra

Los agentes no son el espectáculo; la firma lo es. Esta es su forma real.
El código se mantiene en inglés — la lengua universal de la ingeniería.

"""MatchTop · an agent — it proposes, it never ships on its own.
Standard library only. The agent raises a hand; a person decides."""

from dataclasses import dataclass, field
from datetime import datetime


@dataclass
class Proposal:
    kind: str          # "restock" | "refund" | "reply" | "reconcile"
    detail: dict
    reason: str
    raised_at: datetime = field(default_factory=datetime.utcnow)
    signed: bool = False   # stays False until a human says yes


def watch_stock(store, floor=3):
    """Low stock is not an order. It is a proposal that waits for a signature."""
    for item in store.low_stock(below=floor):
        yield Proposal(
            kind="restock",
            detail={"sku": item.sku, "qty": item.reorder_qty},
            reason=f"{item.sku} at {item.stock}, below floor of {floor}",
        )

"""MatchTop · the sign-off gate — the one door every proposal must pass.
No action reaches the business side of the system unsigned."""

class PermissionError(Exception): pass


def apply(p: Proposal, signer: str | None = None):
    """Raises unless a human has signed. Nothing else gets this proposal through."""
    if not p.signed or signer is None:
        raise PermissionError("no action ships without a human signature")

    store.execute(p)                      # only reachable after sign-off
    log_signature(p, signer)              # every pass through this gate is recorded

"""MatchTop · the signature log — append-only, who signed what, when.
Nothing is edited after the fact; the record is the record."""

import csv
from pathlib import Path
from datetime import datetime

LOG = Path("signatures.csv")


def log_signature(p: Proposal, signer: str) -> None:
    """One line per signed action — auditable by anyone you point at this file."""
    is_new = not LOG.exists()
    with LOG.open("a", newline="") as f:
        w = csv.writer(f)
        if is_new:
            w.writerow(["raised_at", "kind", "reason", "signer", "signed_at"])
        w.writerow([p.raised_at, p.kind, p.reason, signer, datetime.utcnow()])
    return None                            # handed to the record, not to a black box

Lo que no se puede copiar

Por qué los agentes bajo firma superan a los agentes que actúan por su cuenta.

Una IA autónoma no puede merecer su confianza con su dinero — actúa primero y explica después. Una caja negra no puede auditarse. Y un bot sin rostro no puede responder por lo que hizo. Por eso aquí no hay lista de precios: miramos qué necesita que se opere en su operación, lo medimos y cotizamos lo que medimos.

Bajo confidencialidad

Antes de escribir una sola línea, cómo se custodian su tienda y sus datos. Esta parte no es negociable.