agdata 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c8d6174a7bf364de8b95f144a7262f719c122afc0af6e0c217219487dba5aead
+  data.tar.gz: 4d9b04203887168afdfeee1360a17a96e257e487186d362dc805e2cd900c9c31
+SHA512:
+  metadata.gz: 8d331a764b05f724c6e399c37518b752a3992fe51fd9b8206d30f12867e16154e5535c52f6ece1190be9383b9e55c8ae58e4d0d82d7c3292c2337119f32c9ca3
+  data.tar.gz: 2ed3631a0ef9a854deebe7e96dba6277af7a4f3385e75d6267a6d66c1efc2c5e562079aa2d186b4202c822bb69cbea24b6ec4e3ee8a5578ea3f974af2501bddb

data/README.md

@@ -0,0 +1,24 @@
+# agdata
+
+CLI for https://agdata.shveik.dev (the same code as `ag-cli`, which covers all five products).
+
+```sh
+gem install agdata                 # then: agdata endpoints
+agdata endpoints
+agdata docs
+agdata quote <endpoint> '{...}'
+```
+
+Commands: endpoints, docs, pricing, openapi, health, quote, call. It never holds keys and never signs a payment.
+
+## The shveik.dev agent products
+
+Pay-per-call services for AI agents, paid in stablecoins with x402 or MPP, no accounts or API keys. Built by [shveik.dev](https://shveik.dev).
+
+- [agdata](https://agdata.shveik.dev): fresh web data (any URL as Markdown, search, maps, reviews, jobs, social)
+- [agproxy](https://agproxy.shveik.dev): residential proxy packs and a raw fetch
+- [agvps](https://agvps.shveik.dev): Linux servers by the month
+- [agmail](https://agmail.shveik.dev): receive-only agent inboxes
+- [agpay](https://agpay.shveik.dev): custodial hold between two agents
+
+Docs for agents: `/agents.md` on each site. Homepage: https://shveik.dev

data/agdata.gemspec

@@ -0,0 +1,24 @@
+Gem::Specification.new do |spec|
+  spec.name = 'agdata'
+  spec.version = '0.1.1'
+  spec.summary = 'CLI for agdata.shveik.dev (one of the shveik.dev agent products; same code as ag-cli)'
+  spec.description = 'Zero-dependency CLI for agdata.shveik.dev, one of the shveik.dev agent products: list endpoints, show 402 quotes, send payment-signed calls. Same code as ag-cli.'
+  spec.authors = ['shveik.dev']
+  spec.homepage = 'https://agdata.shveik.dev'
+  spec.license = 'MIT'
+  spec.required_ruby_version = '>= 2.7'
+  spec.files = ['agdata.gemspec', 'README.md', 'bin/agdata', 'lib/agdata_cli.rb']
+  spec.bindir = 'bin'
+  spec.executables = ['agdata']
+  spec.require_paths = ['lib']
+  spec.metadata = {
+    'homepage_uri' => 'https://agdata.shveik.dev',
+    'documentation_uri' => 'https://agdata.shveik.dev/agents.md',
+    'shveik_dev' => 'https://shveik.dev',
+    'agdata' => 'https://agdata.shveik.dev',
+    'agproxy' => 'https://agproxy.shveik.dev',
+    'agvps' => 'https://agvps.shveik.dev',
+    'agmail' => 'https://agmail.shveik.dev',
+    'agpay' => 'https://agpay.shveik.dev'
+  }
+end

data/bin/agdata

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require 'agdata_cli'
+
+AgdataCli.main(ARGV)

data/lib/agdata_cli.rb

@@ -0,0 +1,169 @@
+# ag: one small CLI for the shveik.dev agent products (agdata, agproxy, agvps, agmail, agpay).
+# Zero dependencies, Ruby 2.7+ stdlib only. It lists endpoints, shows quotes and sends calls you have
+# signed elsewhere; it never holds keys and never signs a payment.
+require 'json'
+require 'net/http'
+require 'openssl'
+require 'timeout'
+require 'uri'
+
+module AgdataCli
+  VERSION = '0.1.1'
+
+  PRODUCTS = { 'data' => 'agdata', 'proxy' => 'agproxy', 'vps' => 'agvps', 'mail' => 'agmail', 'pay' => 'agpay' }.freeze
+  DEFAULT_PRODUCT = "agdata" # a product-named gem (agvps, agpay, ...) sets this
+
+  USAGE = <<~TEXT
+    ag <product> <command> [args]
+
+    products   data  proxy  vps  mail  pay   (or the full name: agdata, agproxy, ...)
+    commands   endpoints                     list the API endpoints (JSON)
+               docs | pricing | openapi      print the agent guide, the price list, the OpenAPI document
+               health                        liveness check
+               quote <endpoint> [json]       send the call unpaid and print the 402 quote (exit 3)
+               call <endpoint> <json> --payment <signature>
+                                             send a call whose payment you signed elsewhere
+                                             (or set AG_PAYMENT); the CLI never holds keys
+
+    options    --origin <url>                override the service origin (or AG_ORIGIN)
+
+    example    ag data endpoints
+               ag data quote unblock '{"url":"https://example.com"}'
+    exit       0 ok, 1 error, 2 usage, 3 payment required (quote printed)
+  TEXT
+
+  def self.fail_with(message, code = 1)
+    $stderr.write(message + "\n")
+    exit(code)
+  end
+
+  def self.present(value)
+    value.nil? || value.empty? ? nil : value
+  end
+
+  def self.take_option(args, name)
+    at = args.index(name)
+    return nil if at.nil?
+    fail_with("#{name} needs a value", 2) if at + 1 >= args.length
+    value = args[at + 1]
+    args.slice!(at, 2)
+    value
+  end
+
+  def self.show(text)
+    $stdout.write(JSON.pretty_generate(JSON.parse(text)) + "\n")
+  rescue JSON::ParserError
+    $stdout.write(text.end_with?("\n") ? text : text + "\n")
+  end
+
+  # Returns [status, response, text]; HTTP error statuses are returned, not raised.
+  def self.request(url, method = 'GET', body = nil, headers = {})
+    uri = URI.parse(url)
+    10.times do
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == 'https'
+      http.open_timeout = 180
+      http.read_timeout = 180
+      req = method == 'POST' ? Net::HTTP::Post.new(uri.request_uri) : Net::HTTP::Get.new(uri.request_uri)
+      headers.each { |key, value| req[key] = value }
+      req.body = body unless body.nil?
+      response = http.request(req)
+      if response.is_a?(Net::HTTPRedirection) && response['location']
+        code = response.code.to_i
+        uri = URI.join(uri.to_s, response['location'])
+        if [301, 302, 303].include?(code)
+          method = 'GET'
+          body = nil
+        end
+        next
+      end
+      text = response.body.to_s.dup.force_encoding(Encoding::UTF_8).scrub
+      return [response.code.to_i, response, text]
+    end
+    fail_with('request failed: too many redirects')
+  rescue SocketError, SystemCallError, IOError, Timeout::Error, OpenSSL::SSL::SSLError, URI::Error => error
+    fail_with("request failed: #{error.message}")
+  end
+
+  def self.get(origin, path)
+    status, _, text = request(origin + path)
+    fail_with("HTTP #{status} #{path}\n#{text}") if status >= 400
+    show(text)
+  end
+
+  def self.endpoint_path(name)
+    name.start_with?('/') ? name : "/x402/#{name}"
+  end
+
+  def self.paid_request(origin, endpoint, body, extra_headers)
+    headers = { 'content-type' => 'application/json', 'user-agent' => "ag-cli/#{VERSION}" }.merge(extra_headers)
+    request(origin + endpoint_path(endpoint), 'POST', body, headers)
+  end
+
+  def self.show_quote(status, response, text)
+    $stdout.write("HTTP #{status}\n")
+    required = present(response['payment-required'])
+    authenticate = present(response['www-authenticate'])
+    if required
+      show(required.unpack1('m').dup.force_encoding(Encoding::UTF_8).scrub)
+    elsif authenticate
+      $stdout.write("WWW-Authenticate: #{authenticate}\n")
+    else
+      show(text)
+    end
+  end
+
+  def self.main(argv = nil)
+    args = (argv || ARGV).dup
+    origin_option = present(take_option(args, '--origin'))
+    payment = present(take_option(args, '--payment')) || present(ENV['AG_PAYMENT'])
+    full_names = PRODUCTS.values
+    if DEFAULT_PRODUCT && (args.empty? || (!PRODUCTS.key?(args[0]) && !full_names.include?(args[0]) && !%w[products help -h --help].include?(args[0])))
+      args.unshift(DEFAULT_PRODUCT)
+    end
+    if args.empty? || %w[help -h --help].include?(args[0])
+      $stdout.write(USAGE)
+      return
+    end
+    if args[0] == 'products'
+      PRODUCTS.each { |short, full| $stdout.write("#{short}\t#{full}\thttps://#{full}.shveik.dev\n") }
+      return
+    end
+    product = PRODUCTS[args[0]] || (full_names.include?(args[0]) ? args[0] : nil)
+    fail_with(%(unknown product "#{args[0]}"\n\n#{USAGE}), 2) unless product
+    origin = (origin_option || present(ENV['AG_ORIGIN']) || "https://#{product}.shveik.dev").sub(%r{/+\z}, '')
+    command = args.length > 1 ? args[1] : ''
+    rest = args.drop(2)
+    case command
+    when 'endpoints'
+      get(origin, '/v1')
+    when 'docs'
+      get(origin, '/agents.md')
+    when 'pricing'
+      get(origin, '/pricing.md')
+    when 'openapi'
+      get(origin, '/openapi.json')
+    when 'health'
+      get(origin, '/health')
+    when 'quote'
+      fail_with('quote needs an endpoint name or path', 2) if rest.empty?
+      status, response, text = paid_request(origin, rest[0], rest.length > 1 ? rest[1] : '{}', {})
+      show_quote(status, response, text)
+      exit(status == 402 ? 3 : status < 400 ? 0 : 1)
+    when 'call'
+      fail_with('call needs an endpoint and a JSON body', 2) if rest.length < 2
+      fail_with('a signed payment is required: --payment <signature> or AG_PAYMENT (sign the quote with your own wallet)', 2) unless payment
+      status, response, text = paid_request(origin, rest[0], rest[1], { 'PAYMENT-SIGNATURE' => payment })
+      if status == 402
+        show_quote(status, response, text)
+        exit(3)
+      end
+      show(text)
+      exit(status < 400 ? 0 : 1)
+    else
+      fail_with(%(unknown command "#{command}"\n\n#{USAGE}), 2)
+    end
+  end
+end
+
+AgCli.main if __FILE__ == $PROGRAM_NAME

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification
+name: agdata
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- shveik.dev
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-10-08 00:00:00.000000000 Z
+dependencies: []
+description: 'Zero-dependency CLI for agdata.shveik.dev, one of the shveik.dev agent
+  products: list endpoints, show 402 quotes, send payment-signed calls. Same code
+  as ag-cli.'
+email:
+executables:
+- agdata
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- agdata.gemspec
+- bin/agdata
+- lib/agdata_cli.rb
+homepage: https://agdata.shveik.dev
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://agdata.shveik.dev
+  documentation_uri: https://agdata.shveik.dev/agents.md
+  shveik_dev: https://shveik.dev
+  agdata: https://agdata.shveik.dev
+  agproxy: https://agproxy.shveik.dev
+  agvps: https://agvps.shveik.dev
+  agmail: https://agmail.shveik.dev
+  agpay: https://agpay.shveik.dev
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: CLI for agdata.shveik.dev (one of the shveik.dev agent products; same code
+  as ag-cli)
+test_files: []