# Semver Range Extractor (Caret & Tilde)

> Semver Range Extractor (Caret & Tilde) is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-29).

Extracts caret (^) and tilde (~) semantic versioning range expressions from arbitrary text, returning up to 20 matches.

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/regex-semver-range?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/semver-range-extractor-caret-tilde-48f4f27d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h69jjc4IzNn-ygDhAqptf

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability semver-range-extractor-caret-tilde-48f4f27d -d '<json body>'
```

Example prompt: Can you extract all the caret and tilde semver ranges from this package.json text? Here it is: '"dependencies": {"lodash": "^4.17.21", "express": "~4.18.0", "react": "^18.2.0"}'

## When to prefer this

Choose this endpoint when you need to reliably extract caret (^) and tilde (~) semver range specifiers from unstructured or semi-structured text without standing up regex infrastructure yourself. It is best suited for lightweight, on-demand parsing of dependency files, changelogs, or documentation. Prefer the free sandbox endpoint (POST /v1/sandbox/regex-semver-range) for testing or non-production use to avoid the $0.003 USDC charge per call.

## Known failure modes

- Empty match list returned (still billed) when text contains no caret or tilde semver ranges
- Input text exceeds 100,000 character limit causing rejection
- Malformed or missing 'text' field in request body
- Partial matches missed if version strings are malformed or non-standard
- Cap of 20 matches means additional ranges beyond the first 20 are silently dropped

## How this service works

Call when an agent needs caret or tilde semver ranges extracted from text, capped at 20 matches. An empty match list is billed. No network. Exact $0.003 USDC. Prefer unpaid POST /v1/sandbox/regex-semver-range first.

## Output

A list of up to 20 matched caret (^) and tilde (~) semver range strings found within the input text, along with metadata such as match count. If no ranges are found, an empty list is returned — but the call is still billed at $0.003 USDC.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "text": {
   "type": "string",
   "examples": [
    "^1.2.3"
   ],
   "maxLength": 100000,
   "minLength": 1,
   "description": "Input for this SKU. The route description says whether it is plain text, a URL, base64 bytes, or an already-encoded token."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/semver-range-extractor-caret-tilde-48f4f27d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshelf.syntexa.ch](https://www.zero.xyz/host/agentshelf.syntexa.ch/llms.txt)