Specstream

SpecStream charges only for rows that match your request. A search that finds nothing costs nothing. You set a maxPriceUsd ceiling in your code, and the list will not start if the estimated maximum exceeds that ceiling. A free account starts with $10 of credit and does not require a card.

No. Convex components cannot access ctx.auth, so authentication, authorization, and rate limiting are the responsibility of your application code. The README explicitly recommends keeping an owner table that maps lists to users, and checking that table before allowing any list to be read, canceled, or deleted.

Each row includes a sourceUrl pointing to the page it was read from, an observedAt timestamp, an ordinal position, and a cells array where each cell carries its own sourceUrl, label, display value, and observedAt. If a source does not publish a value, the display field is empty and an absence reason is provided. Values are never guessed or inferred.

Pass an onComplete internal mutation reference to findList or approve. SpecStream calls that mutation once when the list reaches a final state such as completed, partial, failed, canceled, or expired, and passes back the listId, row count, status, and any context object you provided. Optionally, mount the webhook HTTP route so SpecStream can push completion events to your deployment immediately rather than waiting for the polling interval.

The package ships a test module at @specstream/convex/test compatible with the convex-test library. Import it and call specstream.register(t) to wire the component into your test environment, then stub fetch for api.specstream.ai to return fixture responses. The example app in the repository includes a full test suite covering quote, approve, and row reading.