# Gateway Agent Commons

A useful stop for agents and their operators.

Start: https://gatewayinformationgroup.com/agents
Structured guide: https://gatewayinformationgroup.com/agents.json

## A website-review recipe

1. Inspect the free playground and its labeled sample:
   https://gateway-wallet-payments.jerryrnapier.workers.dev/agents#playground
2. Read the current service catalog:
   https://gateway-wallet-payments.jerryrnapier.workers.dev/api/agent/v1/catalog
3. Match the service's supported inputs and output to the task. A changes report requires an eligible previous readiness observation. Stop if the required input or baseline is missing.
4. Before paid work, check availability, price, scope, and your operator's authorization. For the main product catalog, require purchase.available === true and use its exact service contract and quote URL. A listed price alone is not an available offer. See https://gatewayinformationgroup.com/developers for payment and retrieval details and current qualification limits.
5. If authorized and suitable, follow the existing quote, authorization, receipt, and private result flow. Preserve recovery information privately. An unpaid quote is not a completed purchase; a confirmed payment is not a completed report.

## Gateway Radar

GET https://gatewayinformationgroup.com/api/agents/radar

Free, on-demand public catalog observations. A successful response contains schemaVersion: 1, source, observedAt (UTC), and records keyed by stable product ID. Compare name, price, availability, contractVersion, inputSchema, and resultSchema. Compare listings by ID to detect additions and removals. Ignore record ordering and observedAt when detecting field changes.

Store a successful snapshot as your own baseline. The page can save one in browser storage when you choose. Keep baseline and current observation times with any comparison. HTTP 503 means unknown: preserve your last successful baseline and stop this check. Do not report unchanged, replace the baseline, or immediately retry in a loop.

Coverage is Gateway's main product catalog only, not every service in the separate wallet catalog. Schema URLs are compared, not schema-document contents. This is not monitoring of arbitrary websites or private customer reports. The endpoint does not schedule future checks, initiate a quote, or authorize spending.

Public development notes: https://gatewayinformationgroup.com/progress.atom

## Optional support

https://gatewayinformationgroup.com/tip?from=agent-commons

A tip is voluntary, requires separate operator permission, and buys no report, priority, or access. Never infer spending authority from this guide. Never share wallet secrets or private report capabilities.

## Find a service before preparing a request

GET https://gatewayinformationgroup.com/api/agents/services

This free, read-only endpoint combines current public service listings with a separate payment-admission observation. It creates no scan, quote, payment or account. It returns supported task IDs, listed USD prices, required fields, request and result examples, schema references, retention, limitations and an observation timestamp. The task selector on /agents uses this same endpoint.

Select the narrowest supported task that answers the actual question: quick, readiness, changes, report, or transaction. A changes report requires the caller's own unexpired passport or changes result for the same website and the original private capability. A Radar catalog baseline is not eligible. Missing services remain absent, not free or enabled. Payment admission can be enabled, disabled or unknown; an enabled observation is not paid-delivery qualification or spending authorization. Refresh discovery and inspect the authoritative quote before any authorized purchase.

On HTTP 503, treat current offers as unknown and stop. Do not keep retrying in a loop or infer availability from an old observation. Unsupported query parameters return 400. This endpoint accepts no website URL or customer input.

The page can copy a read-only handoff with the selected service and sample references. It contains no wallet connection, secret, payment command or spending authorization.

## Compare and share a starting point

After a successful check, the page compares all returned services by their current listed price, scope and baseline requirement. The optional price filter only changes the displayed comparison; it is not a spending limit, quote or authorization. Missing services are not substituted. Check payment admission and service suitability separately.

Share a reviewed task with https://gatewayinformationgroup.com/agents?task=quick#task-desk (replace quick with readiness, changes, report or transaction). This preselects a task without making a discovery request. The recipient chooses when to check current offers. Do not add customer inputs, private report IDs, capabilities or wallet details to a URL.

The “Bring your agent” section provides a copyable read-only starter and a single bounded discovery request:

```sh
curl --fail --silent --show-error --max-time 10 https://gatewayinformationgroup.com/api/agents/services
```

This reads public discovery only. It installs nothing and does not create a quote or payment.
