portage-ucp-client 0.6.2 → 0.6.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 89837fec9676ad52dd925e44ea86b12df99ae2f01ea56eccd4b877bbde7dfb7a
-  data.tar.gz: 34e0f987ba86fb975eaed185950cc6c2690c3f177ae8eacbbdb718560be4fb5e
+  metadata.gz: d79c922ef93a60d8ae293284eb680bb4db51aba09be905ccdd61c0f756723ef5
+  data.tar.gz: f133375b2803b101f0c1bf5e9a70fa88cb6bc7c0126277e303eb909b4fff59aa
 SHA512:
-  metadata.gz: 99581702b0ff34ed5a8fd680ffac05a05576823a6381bf312b63436107fb55977be865f7649be32827b3503b28465e3a862df9730058fe7ba4033179acd28505
-  data.tar.gz: db7d14a2a8149ca8b526ab4fc0ee6f6f807cad84b83eb57229879659e75e5d13207f96faada575354da1981fb78bc2a1de72edc98c38405a81a5efc3ddcfa7e1
+  metadata.gz: a849432b3f19bfb560d54a7bf5d122dafefc55476a98d93708fed59b6f274362bcbff2c7f1799f833f2237e25991d06064b7bf0481a7c29faa7bd7e7a0e84b79
+  data.tar.gz: ee79d83b07f4da1678839b0006de2156112f22327c24e9750bf6c63bf6ef48971e46b9d1e73cc9f136ba11ffa3f4f3fb741b092c6dfb9001b6c69ff6228a492e

data/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to this project are documented here. Format loosely follows
 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/); this project is
 pre-1.0, so APIs may still shift between minor versions.
 
+## [0.6.3] - 2026-09-24
+
+- `Client.connect(url:, proxy:)` and `Client.discover(url, proxy:)` take a
+  `proxy:` option (a URL string, Hash or `URI`), passed straight to
+  Faraday's own `proxy=` on the Streamable HTTP transport. Faraday already
+  reads the env proxy vars itself; this adds an explicit override.
+- Every store-facing request now identifies itself: `Client::USER_AGENT`
+  (`"portage-ucp-client/<ver> (+https://github.com/tomtom87/Portage)"`) is
+  sent on the manifest GET and every UCP transport call, via
+  `Client.with_user_agent(headers)`. A caller's own `User-Agent` header
+  still wins (case-insensitive). `discover(url, headers: {})` now forwards
+  `headers` to both the manifest GET and the transport it builds.
+  `Transports::Http` merges the UA into its `MCP::Client::HTTP` headers.
+
 ## [0.6.2] - 2026-09-23
 
 - Fix: the loopback and stdio transports dropped `cart_id` from every call,

data/lib/portage/ucp/client/transports/http.rb

@@ -25,8 +25,20 @@ module Portage
         class Http
           include UcpWireShape
 
-          def initialize(url:, headers: {})
-            @client = ::MCP::Client.new(transport: ::MCP::Client::HTTP.new(url: url, headers: headers))
+          # @param proxy [String, Hash, URI, nil] docs/plans/proxy-support.md
+          #   Phase 1's "lighter touch" for this gem: Faraday already reads
+          #   the env proxy vars itself (`Faraday.ignore_env_proxy` is
+          #   false) and accepts a `proxy:` connection option, so this just
+          #   wires that option through rather than reimplementing Faraday's
+          #   own proxy handling. Accepts anything
+          #   `Faraday::Connection#proxy=`/`Faraday::ProxyOptions.from`
+          #   accepts — a bare URL string is the common case.
+          def initialize(url:, headers: {}, proxy: nil)
+            @client = ::MCP::Client.new(
+              transport: ::MCP::Client::HTTP.new(url: url, headers: Client.with_user_agent(headers)) do |faraday|
+                faraday.proxy = proxy if proxy
+              end
+            )
             @client.connect
           end
 

data/lib/portage/ucp/client/version.rb

@@ -1,7 +1,7 @@
 module Portage
   module Ucp
     module Client
-      VERSION = "0.6.2".freeze
+      VERSION = "0.6.3".freeze
     end
   end
 end

data/lib/portage/ucp/client.rb

@@ -22,6 +22,11 @@ module Portage
     # Adapter directly, and place an order.
     module Client
       MANIFEST_PATH = "/.well-known/ucp".freeze
+      # Sent on every request this gem makes to a store (the manifest GET and
+      # each Streamable HTTP call) unless the caller's own headers name one,
+      # so a merchant reading its logs can tell a Portage agent from Ruby's
+      # or Faraday's default and find out what it is.
+      USER_AGENT = "portage-ucp-client/#{VERSION} (+https://github.com/tomtom87/Portage)".freeze
 
       # Wraps an already-built Adapter directly — no subprocess/socket. Still
       # runs the real merchant-side contract (authenticator, rate limiter,
@@ -35,11 +40,13 @@ module Portage
 
       # Connects over stdio (a subprocess) or Streamable HTTP (a URL) — pass
       # exactly one of `command:` or `url:`.
-      def self.connect(command: nil, args: [], env: nil, url: nil, headers: {}, capabilities: nil)
+      # @param proxy [String, Hash, nil] forwarded to Transports::Http (a
+      #   `url:` connection only) — see its own doc comment.
+      def self.connect(command: nil, args: [], env: nil, url: nil, headers: {}, capabilities: nil, proxy: nil)
         transport = if command
                       Transports::Stdio.new(command: command, args: args, env: env)
                     elsif url
-                      Transports::Http.new(url: url, headers: headers)
+                      Transports::Http.new(url: url, headers: headers, proxy: proxy)
                     else
                       raise ArgumentError, "connect requires either command: or url:"
                     end
@@ -51,14 +58,19 @@ module Portage
       # Portage::Ucp::Manifest#services — the core-gem fix this client
       # depends on to know where to connect).
       # @return [Session] scoped to the manifest's advertised capabilities.
-      def self.discover(url)
-        manifest = fetch_manifest(url)
-        connect(url: mcp_endpoint(manifest), capabilities: capability_names(manifest))
+      # @param headers [Hash{String => String}] sent with the manifest GET
+      #   and every call after it — e.g. a "User-Agent" naming the app
+      #   built on this gem.
+      # @param proxy [String, Hash, nil] forwarded to the Streamable HTTP
+      #   connection this discovers into — see Transports::Http.
+      def self.discover(url, headers: {}, proxy: nil)
+        manifest = fetch_manifest(url, headers)
+        connect(url: mcp_endpoint(manifest), headers: headers, capabilities: capability_names(manifest), proxy: proxy)
       end
 
-      def self.fetch_manifest(url)
+      def self.fetch_manifest(url, headers = {})
         uri = URI.parse("#{url.to_s.sub(%r{/\z}, '')}#{MANIFEST_PATH}")
-        response = Net::HTTP.get_response(uri)
+        response = Net::HTTP.get_response(uri, with_user_agent(headers))
         raise DiscoveryError, "GET #{uri} returned #{response.code}" unless response.is_a?(Net::HTTPSuccess)
 
         JSON.parse(response.body)
@@ -71,6 +83,13 @@ module Portage
       end
       private_class_method :fetch_manifest
 
+      # USER_AGENT unless `headers` already names one, in any case.
+      def self.with_user_agent(headers)
+        return headers if headers.keys.any? { |name| name.to_s.casecmp?("user-agent") }
+
+        { "User-Agent" => USER_AGENT }.merge(headers)
+      end
+
       # Real UCP manifests (confirmed live on Casper, Allbirds, Glossier, and
       # 34+ other Shopify UCP rollouts as of "2026-08-25") nest everything one
       # level deeper under a "ucp" key. This gem's own server side

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: portage-ucp-client
 version: !ruby/object:Gem::Version
-  version: 0.6.2
+  version: 0.6.3
 platform: ruby
 authors:
 - Tom Whitbread
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-23 00:00:00.000000000 Z
+date: 2026-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday