shareBySquare
shareBySquare for AI Agents

QR-based document handoff for humans, businesses and AI agents

shareBySquare is a QR-based bridge between people, documents, devices, businesses and AI-agent workflows. It helps turn physical documents, QR codes and digital files into simple handoff flows.

Documents QR codes Temporary access Agent-ready direction

Handoff workflows

These scenarios describe how QR-based handoff can connect paper, files and assisted workflows without turning every shared document into a permanent public link.

Human to agent file handoff

A person can create a temporary QR link for a document and let an assistant, browser agent or internal workflow open the same controlled handoff path.

  • Useful for review, intake and follow-up tasks.
  • Keeps access bounded by the selected rules.

Physical document to digital workflow

A paper form, printed report or signed document can carry a QR code that points to a file, upload gate or digital follow-up workflow.

  • Connects offline documents to online actions.
  • Works across phones, tablets and desktops.

QR code on contracts, invoices and service reports

Business documents can include a QR handoff for attachments, evidence, photos, export files or supporting material.

  • Contracts can reference supporting documents.
  • Invoices and service reports can point to temporary evidence files.

Temporary access instead of permanent public links

shareBySquare focuses on temporary access rules such as expiry, password protection, download limits and deletion settings.

  • Designed for short handoff windows.
  • Better suited to one-time document transfer than open-ended public URLs.

Experimental agent-readable manifest layer

The manifest v1 endpoint describes the handoff in a structured way: file intent, expiry, allowed actions, source document type, workflow context, hash claims and validity state.

1

Typed endpoint

Agents can discover the manifest from a download gate, request api/manifest.php?t=TOKEN, and validate the response against schemas/sharebysquare-manifest-v1.schema.json.

2

Signed validity

The manifest includes a signed validity claim with access state, expiry, hash claims and audit head. The AES key is never included.

3

Safe ingestion

The agent policy keeps the handoff in proposal mode: fetch, verify, decrypt only with a user-supplied fragment key, then scan before summarizing or indexing.

Hash trust is explicit: ciphertext_sha256 is server-observed, while payload_sha256 is client-declared and should be verified by an agent after decryption.

Questions

Does shareBySquare give AI agents permanent access to files?

No. shareBySquare is designed around temporary QR links, access rules and deletion settings instead of permanent public file URLs.

Can a QR code be placed on contracts, invoices or service reports?

Yes. A QR code can be used as a handoff point from a physical document to a digital file, intake flow or review workflow.

Is the agent-readable manifest layer available today?

Yes. The experimental v1 manifest endpoint is available at api/manifest.php?t=TOKEN, with public signing keys at api/manifest-keys.php.