Local verification · Hosted deadlines and alerts

Know a scheduled data file failed before the dashboard lies.

Agentsor File Contracts checks CSV and Parquet files where they already live, then reports a small result envelope. Catch a missing delivery, unreadable file, stale event time, row-count breach, or schema change without sending us the file.

Early-access product. No customer result, uptime, error-detection, or downstream business outcome is guaranteed. A passing result proves only the checks that your local verifier actually performed.

LocalFiles are checked in your environment

ExplicitYou define what passing means

QuietAlerts fire on meaningful transitions

How it works

A file check and a deadline, joined by one small receipt.

The verifier runs beside your existing export or import. Agentsor watches for the next authenticated receipt and alerts when the configured contract or schedule fails.

  1. 01

    Write the contract

    Choose CSV or Parquet, required columns and compatible types, row and byte bounds, optional event-time freshness, and the expected run cadence.

  2. 02

    Verify locally

    The MIT-licensed CLI reads the file in your environment and returns passed, failed, or inconclusive with typed check codes.

  3. 03

    Send the receipt

    An ingest token selects the server-side monitor and authenticates a bounded JSON envelope containing the result, timestamps, observed row/byte counts, fixed check codes, and project-keyed contract/schema/output fingerprints.

  4. 04

    Catch silence or drift

    The hosted deadline catches a missing run. Typed transition email distinguishes a missed deadline, failed run, or inconclusive run; exact check and reason details remain in local CLI output.

Data boundary

Your file is not the product.

The verifier is designed so rows and values stay where the job runs. The bearer token selects the server-side monitor; the hosted service stores the fixed receipt, detects a missing receipt, and suppresses an exact duplicate submission. There is no customer dashboard in free early access.

Read the full early-access privacy notice

Receipt may contain

Bounded operational metadata

Envelope version, run identifier, start and finish time, overall status, file format, observed row/byte counts, fixed check and reason codes, and project-keyed contract/schema/output HMAC-SHA256 fingerprints.

Receipt must not contain

Files, values, or access secrets

Rows, cell values, samples, filenames, filesystem paths, query text/results, bucket names, hostnames, storage credentials, personal data, customer records, or arbitrary notes.

Initial contract checks

More evidence than “the cron job exited zero.”

Each check is explicit and independently visible. Unknown or unobservable evidence is marked inconclusive instead of being presented as success.

01

Arrival and deadline

Detect an expected receipt that never arrives or arrives after its configured grace window.

02

Readable structure

Parse CSV structure or Parquet metadata locally and fail closed on malformed or unsupported input.

03

Schema contract

Compare required columns and compatible types, with a stable fingerprint to expose unreviewed change.

04

Freshness and volume

Evaluate configured event-time freshness plus row and byte bounds without transmitting record contents.

05

Idempotent receipt

The server accepts an exact replay of one retained run identifier and envelope without creating a second run. Each new CLI invocation creates a new run identifier.

06

Transition email

Retain redacted receipts for seven days and send typed email when an incident opens or resolves. There is no customer-visible history screen.

Local quickstart

Prove the check locally before creating a monitor.

The MIT-licensed CLI source runs without an account for local checks. It creates a private project fingerprint key, an editable TOML contract, and one fixed JSON result. No file, path, column name, or value is sent.

Python 3.11 or newer is required. Review the generated contract before relying on a result.

Follow the cron-to-missed-run guide

python -m pip install agentsor-file

agentsor-file init \
  --format parquet \
  --contract file-contract.toml \
  --fingerprint-key-file .agentsor-file.key

agentsor-file check YOUR_FILE.parquet \
  --contract file-contract.toml \
  --fingerprint-key-file .agentsor-file.key

Read the complete CLI documentation

Free early-access boundary

One verified request, one free monitor.

No paid plan, checkout, automatic trial, renewal, or charge is currently available. Pricing and limits will be published only after billing, cancellation, and entitlement enforcement are implemented and verified.

Available in source

$0 early access

Each verified request creates one monitor tied to one operational-email recipient. Submitted redacted run receipts have seven-day retention.

Not available

No dashboard or paid plan

There is no customer-visible receipt history, self-serve account console, paid entitlement, or multi-recipient alerting in this early-access release.

Manual support

Email the operator

Token revocation, alert-stop, closure, and data-rights requests are handled manually after authority is verified. In-place token rotation is not available.

Create a free monitor

Verify your email, then receive one ingest token.

Use a business email you control. Give the monitor a non-sensitive label and select the expected cadence. We send one expiring verification link; the raw ingest token is shown once after verification.

Do not enter a customer name, filename, storage path, hostname, personal data, credential, or confidential project identifier.

Use a generic label such as daily-export, not a customer or file name.

Free early access is B2B only. No card, automatic trial, or charge. By continuing you accept the early-access terms and acknowledge the privacy notice.