prompt_builder 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b3f2f981ac5ffaacac8d0f46d3cde5b2429042f34846b36b6a0154fee9858f4
-  data.tar.gz: 7aceebc0337cd9f6f201ccbf822caca50d53ff23e3d2ed165bd7d114c9d9120f
+  metadata.gz: 2572a48b69686a8b061f84fd174dfc164adbfe0c613894bfcbb26fd0039d5108
+  data.tar.gz: c5382987c1d85d31b6cef3f6bb90cc1e4491d1e27d1dd2587d08f2d099360c4f
 SHA512:
-  metadata.gz: 0fdf71137c15a30e7e2cc5740bfa5fc4b7b9a2d31b9959821f84e879b718150dbfd054e15b19e13f53caead242d70ddaaf06e315e79044f77dce1500c6e374cf
-  data.tar.gz: 935a2ac05da1aa179f6107d46e0d37b80b79762111f95f16cda73924e9d9a48733cff1761413b4a8dedb56b8f880b517ed2cd9e196f5ea648e5ae13d909c9e10
+  metadata.gz: 75ac02437e15581cf45c13c592605b6434c0634141bda6d86324e87bb65c59502e1de00f7459c49fb6b3f432a8a2ec2c5487eab4f73de1609c26625bdb37c510
+  data.tar.gz: 3c39ea80cbdb488a63926357601ce47b97cd5940c8ee95742b31b4df30e4b4519cf98dec931e11929ddb80569a0a469736a37aa6337af44dc53092f433051714

data/CHANGELOG.md

@@ -4,20 +4,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## Unreleased
+## 0.1.1
 
 ### Changed
 
-- Serializers now silently omit unsupported features from the serialized output
-  instead of raising `UnsupportedFormatError`. Unsupported session fields, content
-  types, enum values, sub-keys, `tool_choice` variants, and `Compaction`/`ItemReference`
-  items are dropped from request payloads; unrecognized blocks, candidates, and choices
-  are skipped when parsing responses. `UnsupportedFormatError` is still raised for
-  missing required data (e.g. no `model`, no messages, a `json_schema` format without a
-  schema), structural problems, genuine conflicts, unparseable function-call arguments,
-  and streaming response chunks.
+- Responses will now raise an `UnsupportedFormatError` if the response shape is missing key elements.
+- Removed the default `max_tokens` value of 4096 from the request serializer. If `max_output_tokens` is not set on the session, the request will simply omit the `max_tokens` parameter, allowing the API to apply its own defaults.
 
-## 1.0.0
+## 0.1.0
 
 ### Added
 

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.1

data/lib/prompt_builder/errors.rb

@@ -15,4 +15,7 @@ module PromptBuilder
 
   # Raised when an operation is invalid for the current session state.
   class InvalidStateError < Error; end
+
+  # Raised when a response payload does not match the expected shape.
+  class UnexpectedPayloadError < Error; end
 end

data/lib/prompt_builder/serializers/base.rb

@@ -31,6 +31,22 @@ module PromptBuilder
         def deserialize_response(_hash)
           raise NotImplementedError
         end
+
+        # Ensure a response payload is a Hash containing the key that identifies
+        # it as a well-formed response for this format. Raised before parsing so
+        # malformed bodies (e.g. provider error envelopes) fail loudly with the
+        # offending body rather than producing a silently empty Response.
+        #
+        # @param hash [Object] the raw response payload
+        # @param key [String] a key that must be present in a valid payload
+        # @raise [UnexpectedPayloadError] if the key is missing
+        def require_response_key!(hash, key)
+          return if hash.is_a?(Hash) && hash.key?(key)
+
+          body = JSON.generate(hash)[0..200]
+          raise UnexpectedPayloadError,
+            "unexpected response payload, missing #{key.inspect}: #{body}"
+        end
       end
     end
   end

data/lib/prompt_builder/serializers/chat_completion/response.rb

@@ -109,6 +109,8 @@ module PromptBuilder
             if hash["object"] == "chat.completion.chunk"
               raise UnsupportedFormatError, "Chat Completions streaming chunks are not supported"
             end
+            require_response_key!(hash, "choices")
+            require_response_key!(hash, "model")
             # Responses with multiple choices have no canonical multi-candidate
             # representation; only the first choice is parsed (handled by the
             # caller using choices[0]).

data/lib/prompt_builder/serializers/converse/response.rb

@@ -11,6 +11,9 @@ module PromptBuilder
           private
 
           def deserialize_response(hash)
+            require_response_key!(hash, "output")
+            require_response_key!(hash, "stopReason")
+
             usage_hash = hash["usage"]
             usage = if usage_hash
               cache_read = usage_hash["cacheReadInputTokens"]

data/lib/prompt_builder/serializers/gemini/response.rb

@@ -64,6 +64,9 @@ module PromptBuilder
           private
 
           def deserialize_response(hash)
+            require_response_key!(hash, "candidates")
+            require_response_key!(hash, "modelVersion")
+
             usage = build_usage(hash["usageMetadata"])
 
             # Only the first candidate is parsed; additional candidates have no

data/lib/prompt_builder/serializers/messages/request.rb

@@ -71,7 +71,6 @@ module PromptBuilder
       # - +anthropic-beta+ headers and API versioning (this gem produces no HTTP
       #   request — set headers in your HTTP client)
       class Request < Base
-        DEFAULT_MAX_TOKENS = 4096
         SUPPORTED_METADATA_KEYS = ["user_id"].freeze
         EFFORT_LEVELS = ["low", "medium", "high", "xhigh", "max"].freeze
         SUPPORTED_THINKING_TYPES = ["adaptive", "disabled", "enabled"].freeze
@@ -85,7 +84,7 @@ module PromptBuilder
             raise UnsupportedFormatError, "Messages format requires session.model" unless session.model
 
             h["model"] = session.model
-            h["max_tokens"] = session.max_output_tokens || DEFAULT_MAX_TOKENS
+            h["max_tokens"] = session.max_output_tokens if session.max_output_tokens
             h["temperature"] = session.temperature if session.temperature
             h["top_p"] = session.top_p if session.top_p
             effective_metadata = build_effective_metadata(session)

data/lib/prompt_builder/serializers/messages/response.rb

@@ -11,6 +11,9 @@ module PromptBuilder
           private
 
           def deserialize_response(hash)
+            require_response_key!(hash, "content")
+            require_response_key!(hash, "stop_reason")
+
             usage_hash = hash["usage"]
             usage = build_usage(usage_hash) if usage_hash
 

data/lib/prompt_builder/serializers/open_responses/response.rb

@@ -9,6 +9,9 @@ module PromptBuilder
           private
 
           def deserialize_response(hash)
+            require_response_key!(hash, "status")
+            require_response_key!(hash, "object")
+
             PromptBuilder::Response.from_h(hash)
           end
         end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: prompt_builder
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Brian Durand