lingara 0.1.0.pre.alpha.13 → 0.2.0.pre.alpha.1

data/lib/lingara/models/world_context_changed.rb

@@ -3,7 +3,7 @@
 
 #Generate vocabulary lists and lesson plans, and hold tutor conversations, in the languages Lingara teaches. Each call is paid for by the client that makes it: an `allowance` client spends its owner's allowance, and a `metered` client is billed for its usage.
 
-The version of the OpenAPI document: 2026-10-affable-towhee
+The version of the OpenAPI document: 2026-10-golden-remora
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.14.0

data/lib/lingara/models/world_practice_completed.rb

@@ -0,0 +1,294 @@
+=begin
+#Lingara API
+
+#Generate vocabulary lists and lesson plans, and hold tutor conversations, in the languages Lingara teaches. Each call is paid for by the client that makes it: an `allowance` client spends its owner's allowance, and a `metered` client is billed for its usage.
+
+The version of the OpenAPI document: 2026-10-golden-remora
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.14.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Lingara
+  class WorldPracticeCompleted
+    attr_accessor :plan_id
+
+    attr_accessor :items
+
+    attr_accessor :completed
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'plan_id' => :'plan_id',
+        :'items' => :'items',
+        :'completed' => :'completed'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'plan_id' => :'String',
+        :'items' => :'Array<PracticeItem>',
+        :'completed' => :'Boolean'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Lingara::WorldPracticeCompleted` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Lingara::WorldPracticeCompleted`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'plan_id')
+        self.plan_id = attributes[:'plan_id']
+      else
+        self.plan_id = nil
+      end
+
+      if attributes.key?(:'items')
+        if (value = attributes[:'items']).is_a?(Array)
+          self.items = value
+        end
+      else
+        self.items = nil
+      end
+
+      if attributes.key?(:'completed')
+        self.completed = attributes[:'completed']
+      else
+        self.completed = false
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @plan_id.nil?
+        invalid_properties.push('invalid value for "plan_id", plan_id cannot be nil.')
+      end
+
+      if @items.nil?
+        invalid_properties.push('invalid value for "items", items cannot be nil.')
+      end
+
+      if @items.length > 100
+        invalid_properties.push('invalid value for "items", number of items must be less than or equal to 100.')
+      end
+
+      if @items.length < 1
+        invalid_properties.push('invalid value for "items", number of items must be greater than or equal to 1.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @plan_id.nil?
+      return false if @items.nil?
+      return false if @items.length > 100
+      return false if @items.length < 1
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] plan_id Value to be assigned
+    def plan_id=(plan_id)
+      if plan_id.nil?
+        fail ArgumentError, 'plan_id cannot be nil'
+      end
+
+      @plan_id = plan_id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] items Value to be assigned
+    def items=(items)
+      if items.nil?
+        fail ArgumentError, 'items cannot be nil'
+      end
+
+      if items.length > 100
+        fail ArgumentError, 'invalid value for "items", number of items must be less than or equal to 100.'
+      end
+
+      if items.length < 1
+        fail ArgumentError, 'invalid value for "items", number of items must be greater than or equal to 1.'
+      end
+
+      @items = items
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          plan_id == o.plan_id &&
+          items == o.items &&
+          completed == o.completed
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [plan_id, items, completed].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Deserializes the data based on type
+    # @param string type Data type
+    # @param string value Value to be deserialized
+    # @return [Object] Deserialized data
+    def self._deserialize(type, value)
+      case type.to_sym
+      when :Time
+        Time.parse(value)
+      when :Date
+        Date.parse(value)
+      when :String
+        value.to_s
+      when :Integer
+        value.to_i
+      when :Float
+        value.to_f
+      when :Boolean
+        if value.to_s =~ /\A(true|t|yes|y|1)\z/i
+          true
+        else
+          false
+        end
+      when :Object
+        # generic object (usually a Hash), return directly
+        value
+      when /\AArray<(?<inner_type>.+)>\z/
+        inner_type = Regexp.last_match[:inner_type]
+        value.map { |v| _deserialize(inner_type, v) }
+      when /\AHash<(?<k_type>.+?), (?<v_type>.+)>\z/
+        k_type = Regexp.last_match[:k_type]
+        v_type = Regexp.last_match[:v_type]
+        {}.tap do |hash|
+          value.each do |k, v|
+            hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
+          end
+        end
+      else # model
+        # models (e.g. Pet) or oneOf
+        klass = Lingara.const_get(type)
+        klass.respond_to?(:openapi_any_of) || klass.respond_to?(:openapi_one_of) ? klass.build(value) : klass.build_from_hash(value)
+      end
+    end
+
+    # Returns the string representation of the object
+    # @return [String] String presentation of the object
+    def to_s
+      to_hash.to_s
+    end
+
+    # to_body is an alias to to_hash (backward compatibility)
+    # @return [Hash] Returns the object in the form of hash
+    def to_body
+      to_hash
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+    # Outputs non-array value in the form of hash
+    # For object, use to_hash. Otherwise, just return the value
+    # @param [Object] value Any valid value
+    # @return [Hash] Returns the value in the form of hash
+    def _to_hash(value)
+      if value.is_a?(Array)
+        value.compact.map { |v| _to_hash(v) }
+      elsif value.is_a?(Hash)
+        {}.tap do |hash|
+          value.each { |k, v| hash[k] = _to_hash(v) }
+        end
+      elsif value.respond_to? :to_hash
+        value.to_hash
+      else
+        value
+      end
+    end
+
+  end
+
+end

data/lib/lingara/models/world_practice_requested.rb

@@ -3,7 +3,7 @@
 
 #Generate vocabulary lists and lesson plans, and hold tutor conversations, in the languages Lingara teaches. Each call is paid for by the client that makes it: an `allowance` client spends its owner's allowance, and a `metered` client is billed for its usage.
 
-The version of the OpenAPI document: 2026-10-affable-towhee
+The version of the OpenAPI document: 2026-10-golden-remora
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.14.0

data/lib/lingara/operations.rb

@@ -6,6 +6,15 @@ module Lingara
   # is its terminal table: :yield (yielded, then the stream ends), :quiet
   # (a Done payload, never yielded) and :raise (the error event).
   OPERATIONS = {
+    "createEmbedToken" => {
+      method: "POST",
+      path: "/v1/embed/tokens",
+      path_params: [].freeze,
+      needs_token: true,
+      request_body: "EmbedTokenRequest",
+      response: "EmbedToken",
+      stream: nil
+    }.freeze,
     "createLessonPlan" => {
       method: "POST",
       path: "/v1/lesson-plans",
@@ -15,6 +24,15 @@ module Lingara
       response: nil,
       stream: {union: "CreateLessonPlanEvent", events: {"started" => "CreateLessonPlanEventStarted", "phase" => "CreateLessonPlanEventPhase", "result" => "CreateLessonPlanEventResult", "error" => "CreateLessonPlanEventError"}.freeze, ends: {"result" => :yield, "error" => :raise}.freeze}.freeze
     }.freeze,
+    "deleteEmbedPlayer" => {
+      method: "DELETE",
+      path: "/v1/embed/players/{player_ref}",
+      path_params: ["player_ref"].freeze,
+      needs_token: true,
+      request_body: nil,
+      response: nil,
+      stream: nil
+    }.freeze,
     "generateVocabulary" => {
       method: "POST",
       path: "/v1/vocab/stream",
@@ -87,6 +105,15 @@ module Lingara
       response: "EventPage",
       stream: nil
     }.freeze,
+    "sendDialogueTurn" => {
+      method: "POST",
+      path: "/v1/embed/dialogue/turns",
+      path_params: [].freeze,
+      needs_token: true,
+      request_body: "DialogueTurnRequest",
+      response: nil,
+      stream: {union: "SendDialogueTurnEvent", events: {"delta" => "SendDialogueTurnEventDelta", "notice" => "SendDialogueTurnEventNotice", "done" => "SendDialogueTurnEventDone", "error" => "SendDialogueTurnEventError"}.freeze, ends: {"done" => :quiet, "error" => :raise}.freeze}.freeze
+    }.freeze,
     "sendEvent" => {
       method: "POST",
       path: "/v1/events",

data/lib/lingara/streams.rb

@@ -51,6 +51,31 @@ module Lingara
     end
   end
 
+  # One event of sendDialogueTurn's stream: `case event in SendDialogueTurnEvent` matches
+  # any of its branches. The error branch, and a Done-bodied one, are never
+  # yielded.
+  module SendDialogueTurnEvent
+    BRANCHES = {
+      "delta" => SendDialogueTurnEventDelta,
+      "notice" => SendDialogueTurnEventNotice,
+      "done" => SendDialogueTurnEventDone,
+      "error" => SendDialogueTurnEventError
+    }.freeze
+
+    def self.===(other)
+      BRANCHES.value?(other.class)
+    end
+
+    # The branch for a known event name, decoded from its `data` JSON text,
+    # or nil for an unknown name. A known event whose data is not a JSON
+    # object, or that its branch refuses, raises TransportError
+    # :malformed_event.
+    def self.decode(name, data)
+      branch = BRANCHES[name]
+      branch && Lingara::Decoding.event(branch, name, data)
+    end
+  end
+
   # One event of sendTutorMessage's stream: `case event in SendTutorMessageEvent` matches
   # any of its branches. The error branch, and a Done-bodied one, are never
   # yielded.

data/lib/lingara/version.rb

@@ -2,12 +2,12 @@
 
 module Lingara
   # This library's released version, SemVer, sent in every User-Agent (K6).
-  VERSION = "0.1.0-alpha.13"
+  VERSION = "0.2.0-alpha.1"
 
   # The same version in RubyGems' spelling, which the gemspec uses.
-  GEM_VERSION = "0.1.0.pre.alpha.13"
+  GEM_VERSION = "0.2.0.pre.alpha.1"
 
   # The /v1 version this library's models were generated from. A response
   # served under another version logs one warning per version id.
-  GENERATED_FOR_VERSION = "2026-10-affable-towhee"
+  GENERATED_FOR_VERSION = "2026-10-golden-remora"
 end

data/lib/lingara.rb

@@ -13,6 +13,7 @@ require_relative "lingara/user_agent"
 require_relative "lingara/deprecation"
 require_relative "lingara/sse_decoder"
 require_relative "lingara/response"
+require_relative "lingara/minted_token"
 
 Dir[File.join(__dir__, "lingara/models/*.rb")].sort.each { |file| require file }
 

data/sig/lingara.rbs

@@ -67,6 +67,26 @@ module Lingara
     def tail_events: (?cursor: String?, ?start: (String | Symbol)?, ?types: Array[String]?) { (Events::Event) -> void } -> bot
                    | (?cursor: String?, ?start: (String | Symbol)?, ?types: Array[String]?) -> Events::Tail
     def send_event: (Events::InboundEvent event, ?idempotency_key: String?) -> Response
+
+    # ADR 1.10.26w: embedding. create_embed_token's Response holds a MintedToken.
+    def create_embed_token: (**untyped body) -> Response
+    def delete_embed_player: (String player_ref) -> Response
+    def send_dialogue_turn: (**untyped body) { (event) -> void } -> StreamResult
+  end
+
+  class MintedToken
+    PREFIX: String
+    FIELDS: Hash[String, untyped]
+
+    attr_reader token: AccessToken
+    attr_reader expires_at: Time
+    attr_reader expires_in: Integer
+    attr_reader subject: String
+    attr_reader scopes: Array[String]
+    attr_reader account_linked: bool
+
+    def self.decode: (String body) -> MintedToken
+    def initialize: (token: AccessToken, expires_at: Time, expires_in: Integer, subject: String, scopes: Array[String], account_linked: bool) -> void
   end
 
   # ADR 30.9.26aa: the event union, the verifier, the feed and the tail.
@@ -109,6 +129,18 @@ module Lingara
       include Event
     end
 
+    class AppDisabled < ::Data
+      include Event
+    end
+
+    class AppEnabled < ::Data
+      include Event
+    end
+
+    class PracticeCompleted < ::Data
+      include Event
+    end
+
     class UnknownEvent < ::Data
       include Event
     end
@@ -121,6 +153,7 @@ module Lingara
 
       def self.world_context_changed: (untyped data) -> InboundEvent
       def self.world_practice_requested: (untyped data) -> InboundEvent
+      def self.world_practice_completed: (untyped data) -> InboundEvent
       def to_hash: () -> Hash[String, untyped]
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lingara
 version: !ruby/object:Gem::Version
-  version: 0.1.0.pre.alpha.13
+  version: 0.2.0.pre.alpha.1
 platform: ruby
 authors:
 - Spinning Cat Studios
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-06 00:00:00.000000000 Z
+date: 2026-10-09 00:00:00.000000000 Z
 dependencies: []
 description: Generate vocabulary lists and lesson plans, and hold tutor conversations,
   through the Lingara API. Streams are blocks or Enumerables; the standard library
@@ -32,14 +32,21 @@ files:
 - lib/lingara/events/feed.rb
 - lib/lingara/events/tail.rb
 - lib/lingara/events/webhook.rb
+- lib/lingara/minted_token.rb
 - lib/lingara/models/allowance_row.rb
 - lib/lingara/models/app_context_slice.rb
+- lib/lingara/models/app_disabled_data.rb
+- lib/lingara/models/app_enabled_data.rb
 - lib/lingara/models/app_installed_data.rb
 - lib/lingara/models/app_uninstalled_data.rb
 - lib/lingara/models/create_lesson_plan_event_error.rb
 - lib/lingara/models/create_lesson_plan_event_phase.rb
 - lib/lingara/models/create_lesson_plan_event_result.rb
 - lib/lingara/models/create_lesson_plan_event_started.rb
+- lib/lingara/models/dialogue_entry.rb
+- lib/lingara/models/dialogue_turn_request.rb
+- lib/lingara/models/embed_token.rb
+- lib/lingara/models/embed_token_request.rb
 - lib/lingara/models/error_envelope.rb
 - lib/lingara/models/event_envelope.rb
 - lib/lingara/models/event_page.rb
@@ -65,12 +72,20 @@ files:
 - lib/lingara/models/plan_started.rb
 - lib/lingara/models/plan_status.rb
 - lib/lingara/models/plan_word.rb
+- lib/lingara/models/practice_completed_data.rb
+- lib/lingara/models/practice_item.rb
+- lib/lingara/models/practice_outcome.rb
 - lib/lingara/models/reaction_report.rb
 - lib/lingara/models/reaction_status.rb
+- lib/lingara/models/send_dialogue_turn_event_delta.rb
+- lib/lingara/models/send_dialogue_turn_event_done.rb
+- lib/lingara/models/send_dialogue_turn_event_error.rb
+- lib/lingara/models/send_dialogue_turn_event_notice.rb
 - lib/lingara/models/send_tutor_message_event_delta.rb
 - lib/lingara/models/send_tutor_message_event_done.rb
 - lib/lingara/models/send_tutor_message_event_error.rb
 - lib/lingara/models/send_tutor_message_event_notice.rb
+- lib/lingara/models/speaker.rb
 - lib/lingara/models/stream_error.rb
 - lib/lingara/models/stream_events_event_done.rb
 - lib/lingara/models/stream_events_event_error.rb
@@ -100,6 +115,7 @@ files:
 - lib/lingara/models/vocab_request.rb
 - lib/lingara/models/vocab_started.rb
 - lib/lingara/models/world_context_changed.rb
+- lib/lingara/models/world_practice_completed.rb
 - lib/lingara/models/world_practice_requested.rb
 - lib/lingara/operations.rb
 - lib/lingara/response.rb