ipvolt Proxy Toolkit

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['client', 'version', 'phase'], 'properties': {'phase': {'enum': ['configuration', 'pool', 'proxy_connect', 'connect_tunnel', 'target_tls', 'request_send', 'response_headers', 'response_body', 'unknown'], 'type': 'string'}, 'client': {'enum': ['curl', 'requests', 'httpx', 'playwright'], 'type': 'string'}, 'method': {'enum': ['GET', 'HEAD', 'OPTIONS', 'PUT', 'DELETE', 'POST', 'PATCH', 'unknown'], 'type': 'string', 'default': 'unknown'}, 'status': {'type': 'integer', 'maximum': 599, 'minimum': 100, 'description': 'Observed HTTP status; identify its responding layer separately.'}, 'version': {'enum': ['8.22.0', '2.34.2', '0.28.1', '1.63.0'], 'type': 'string'}, 'exception': {'enum': ['proxy_error', 'tls_error', 'connect_timeout', 'read_timeout', 'write_timeout', 'pool_timeout', 'connection_refused', 'dns_error', 'connection_reset', 'protocol_error', 'timeout', 'invalid_configuration', 'unknown'], 'type': 'string', 'description': 'Normalized category, not raw exception text. HTTPX ConnectError alone does not establish a TLS error.'}, 'responseSource': {'enum': ['proxy', 'target', 'unknown'], 'type': 'string', 'default': 'unknown', 'description': 'Use target/proxy only when established by response provenance, not merely the status code.'}, 'retryAfterSeconds': {'type': 'integer', 'maximum': 86400, 'minimum': 0, 'description': 'Parsed bounded Retry-After delay, if actually observed. Never submit the raw header.'}, 'requestMayHaveBeenSent': {'type': 'boolean', 'description': 'Whether this target request may already have reached the application. Omit when unknown.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['client', 'version', 'rulesRevision', 'evidence', 'summary', 'candidates', 'uncertainty', 'retry', 'sources'], 'properties': {'retry': {'type': 'object', 'required': ['automaticRetryRecommended', 'category', 'advice'], 'properties': {'advice': {'type': 'string'}, 'category': {'enum': ['reconcile_before_repeating', 'bounded_retry_after_cause_check'], 'type': 'string'}, 'automaticRetryRecommended': {'type': 'boolean', 'const': False}}, 'additionalProperties': False}, 'client': {'enum': ['curl', 'requests', 'httpx', 'playwright'], 'type': 'string'}, 'sources': {'type': 'array', 'items': {'type': 'string', 'format': 'uri'}, 'maxItems': 6}, 'summary': {'type': 'string'}, 'version': {'enum': ['8.22.0', '2.34.2', '0.28.1', '1.63.0'], 'type': 'string'}, 'evidence': {'type': 'object', 'required': ['client', 'version', 'phase', 'responseSource', 'method'], 'properties': {'phase': {'enum': ['configuration', 'pool', 'proxy_connect', 'connect_tunnel', 'target_tls', 'request_send', 'response_headers', 'response_body', 'unknown'], 'type': 'string'}, 'client': {'enum': ['curl', 'requests', 'httpx', 'playwright'], 'type': 'string'}, 'method': {'enum': ['GET', 'HEAD', 'OPTIONS', 'PUT', 'DELETE', 'POST', 'PATCH', 'unknown'], 'type': 'string', 'default': 'unknown'}, 'status': {'type': 'integer', 'maximum': 599, 'minimum': 100, 'description': 'Observed HTTP status; identify its responding layer separately.'}, 'version': {'enum': ['8.22.0', '2.34.2', '0.28.1', '1.63.0'], 'type': 'string'}, 'exception': {'enum': ['proxy_error', 'tls_error', 'connect_timeout', 'read_timeout', 'write_timeout', 'pool_timeout', 'connection_refused', 'dns_error', 'connection_reset', 'protocol_error', 'timeout', 'invalid_configuration', 'unknown'], 'type': 'string', 'description': 'Normalized category, not raw exception text. HTTPX ConnectError alone does not establish a TLS error.'}, 'responseSource': {'enum': ['proxy', 'target', 'unknown'], 'type': 'string', 'default': 'unknown', 'description': 'Use target/proxy only when established by response provenance, not merely the status code.'}, 'retryAfterSeconds': {'type': 'integer', 'maximum': 86400, 'minimum': 0, 'description': 'Parsed bounded Retry-After delay, if actually observed. Never submit the raw header.'}, 'requestMayHaveBeenSent': {'type': 'boolean', 'description': 'Whether this target request may already have reached the application. Omit when unknown.'}}, 'additionalProperties': False}, 'candidates': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'confidence', 'explanation', 'nextCheck'], 'properties': {'code': {'type': 'string'}, 'nextCheck': {'type': 'string'}, 'confidence': {'enum': ['supported', 'possible'], 'type': 'string'}, 'explanation': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 5, 'minItems': 1}, 'uncertainty': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 6}, 'rulesRevision': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['client', 'version'], 'properties': {'client': {'enum': ['curl', 'requests', 'httpx', 'playwright'], 'type': 'string', 'description': 'Client whose exact tested configuration to generate.'}, 'version': {'enum': ['8.22.0', '2.34.2', '0.28.1', '1.63.0'], 'type': 'string', 'description': 'Exact tested version matching the client. Other versions are unsupported.'}, 'protocol': {'type': 'string', 'const': 'http', 'default': 'http', 'description': 'HTTP proxy with HTTPS CONNECT. Other proxy protocols are not tested.'}, 'timeoutSeconds': {'type': 'integer', 'default': 15, 'maximum': 60, 'minimum': 1}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['client', 'version', 'protocol', 'templateRevision', 'language', 'interface', 'testedRuntime', 'code', 'environment', 'behavior', 'limitations', 'summary', 'sources'], 'properties': {'code': {'type': 'string', 'maxLength': 16384}, 'client': {'enum': ['curl', 'requests', 'httpx', 'playwright'], 'type': 'string'}, 'sources': {'type': 'array', 'items': {'type': 'string', 'format': 'uri'}, 'maxItems': 3}, 'summary': {'type': 'string'}, 'version': {'enum': ['8.22.0', '2.34.2', '0.28.1', '1.63.0'], 'type': 'string'}, 'behavior': {'type': 'object', 'required': ['method', 'followsRedirects', 'automaticRetries', 'bypassesProxy', 'verifiesTargetTls', 'output', 'timeoutSeconds', 'timeoutScope'], 'properties': {'method': {'type': 'string', 'const': 'GET'}, 'output': {'type': 'string'}, 'timeoutScope': {'type': 'string'}, 'bypassesProxy': {'type': 'boolean', 'const': False}, 'timeoutSeconds': {'type': 'integer', 'maximum': 60, 'minimum': 1}, 'automaticRetries': {'type': 'number', 'const': 0}, 'followsRedirects': {'type': 'boolean', 'const': False}, 'verifiesTargetTls': {'type': 'boolean', 'const': True}}, 'additionalProperties': False}, 'language': {'enum': ['sh', 'python', 'javascript'], 'type': 'string'}, 'protocol': {'type': 'string', 'const': 'http'}, 'interface': {'type': 'string'}, 'environment': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'required', 'secret', 'description'], 'properties': {'name': {'type': 'string'}, 'secret': {'type': 'boolean'}, 'required': {'type': 'boolean'}, 'description': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 3}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 4}, 'testedRuntime': {'type': 'string'}, 'templateRevision': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['documentId'], 'properties': {'cursor': {'type': 'string', 'pattern': '^[a-f0-9]{16}:\\d{1,5}$'}, 'section': {'type': 'string', 'maxLength': 160, 'minLength': 1}, 'documentId': {'type': 'string', 'pattern': '^\\/(guides|blog)\\/[a-z0-9]+(?:-[a-z0-9]+)*$', 'maxLength': 160}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['document', 'markdown', 'sections', 'chunk', 'totalChunks', 'nextCursor', 'provenance'], 'properties': {'chunk': {'type': 'number'}, 'document': {'type': 'object', 'required': ['id', 'title', 'description', 'reviewedAt', 'topic', 'url', 'sha256'], 'properties': {'id': {'type': 'string', 'pattern': '^\\/(guides|blog)\\/[a-z0-9]+(?:-[a-z0-9]+)*$', 'maxLength': 160}, 'url': {'type': 'string', 'format': 'uri'}, 'title': {'type': 'string', 'maxLength': 250, 'minLength': 1}, 'topic': {'enum': ['setup', 'troubleshooting', 'concepts', 'countries', 'analysis'], 'type': 'string'}, 'sha256': {'type': 'string', 'pattern': '^[a-f0-9]{64}$'}, 'reviewedAt': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'description': {'type': 'string', 'maxLength': 1000}}, 'additionalProperties': False}, 'markdown': {'type': 'string'}, 'sections': {'type': 'array', 'items': {'type': 'string'}}, 'nextCursor': {'type': ['string', 'null']}, 'provenance': {'type': 'object', 'required': ['sourceRelease', 'bundleSha256', 'generatedAt'], 'properties': {'generatedAt': {'type': 'string'}, 'bundleSha256': {'type': 'string', 'pattern': '^[a-f0-9]{64}$'}, 'sourceRelease': {'type': 'string'}}, 'additionalProperties': False}, 'totalChunks': {'type': 'number'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 5, 'maximum': 5, 'minimum': 1}, 'query': {'type': 'string', 'maxLength': 200, 'minLength': 2}, 'topic': {'enum': ['setup', 'troubleshooting', 'concepts', 'countries', 'analysis'], 'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['results', 'provenance'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'description', 'reviewedAt', 'topic', 'url', 'sha256', 'snippet', 'score'], 'properties': {'id': {'type': 'string', 'pattern': '^\\/(guides|blog)\\/[a-z0-9]+(?:-[a-z0-9]+)*$', 'maxLength': 160}, 'url': {'type': 'string', 'format': 'uri'}, 'score': {'type': 'number'}, 'title': {'type': 'string', 'maxLength': 250, 'minLength': 1}, 'topic': {'enum': ['setup', 'troubleshooting', 'concepts', 'countries', 'analysis'], 'type': 'string'}, 'sha256': {'type': 'string', 'pattern': '^[a-f0-9]{64}$'}, 'snippet': {'type': 'string'}, 'reviewedAt': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'description': {'type': 'string', 'maxLength': 1000}}, 'additionalProperties': False}}, 'provenance': {'type': 'object', 'required': ['sourceRelease', 'bundleSha256', 'generatedAt'], 'properties': {'generatedAt': {'type': 'string'}, 'bundleSha256': {'type': 'string', 'pattern': '^[a-f0-9]{64}$'}, 'sourceRelease': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}