langgraph-platform 0.1.0

data/lib/langgraph_platform/resources/store.rb

@@ -0,0 +1,55 @@
+module LanggraphPlatform
+  module Resources
+    class Store < BaseResource
+      def get(namespace, key)
+        response = @client.get("/store/#{namespace}/#{key}")
+        Models::StoreItem.new(response)
+      end
+
+      def put(namespace, key, **params)
+        body = compact_params(params)
+        response = @client.put("/store/#{namespace}/#{key}", body)
+        Models::StoreItem.new(response)
+      end
+
+      def delete(namespace, key) # rubocop:disable Naming/PredicateMethod
+        @client.delete("/store/#{namespace}/#{key}")
+        true
+      end
+
+      def list(namespace, **params)
+        params[:limit] ||= 10
+        params[:offset] ||= 0
+        query_params = compact_params(params)
+        response = @client.get("/store/#{namespace}", query_params)
+        response.map { |item_data| Models::StoreItem.new(item_data) }
+      end
+
+      def search(**params)
+        params[:limit] ||= 10
+        params[:offset] ||= 0
+        body = compact_params(params)
+        response = @client.post('/store/search', body)
+        response.map { |item_data| Models::StoreItem.new(item_data) }
+      end
+
+      def batch_get(**params)
+        body = compact_params(params)
+        response = @client.post('/store/batch', body)
+        response.map { |item_data| Models::StoreItem.new(item_data) }
+      end
+
+      def batch_put(**params)
+        body = compact_params(params)
+        response = @client.put('/store/batch', body)
+        response.map { |item_data| Models::StoreItem.new(item_data) }
+      end
+
+      def batch_delete(**params) # rubocop:disable Naming/PredicateMethod
+        body = compact_params(params)
+        @client.delete('/store/batch', body)
+        true
+      end
+    end
+  end
+end

data/lib/langgraph_platform/resources/threads.rb

@@ -0,0 +1,63 @@
+module LanggraphPlatform
+  module Resources
+    class Threads < BaseResource
+      def create(**params)
+        params[:metadata] ||= {}
+        body = compact_params(params)
+        response = @client.post('/threads', body)
+        Models::Thread.new(response)
+      end
+
+      def find(thread_id)
+        response = @client.get("/threads/#{thread_id}")
+        Models::Thread.new(response)
+      end
+
+      def update(thread_id, **params)
+        params[:metadata] ||= {}
+        body = compact_params(params)
+        response = @client.patch("/threads/#{thread_id}", body)
+        Models::Thread.new(response)
+      end
+
+      def delete(thread_id) # rubocop:disable Naming/PredicateMethod
+        @client.delete("/threads/#{thread_id}")
+        true
+      end
+
+      def search(**params)
+        params[:metadata] ||= {}
+        params[:values] ||= {}
+        params[:limit] ||= 10
+        params[:offset] ||= 0
+        body = compact_params(params)
+        response = @client.post('/threads/search', body)
+        response.map { |thread_data| Models::Thread.new(thread_data) }
+      end
+
+      def state(thread_id, **params)
+        params[:subgraphs] ||= false
+        query_params = compact_params(params)
+        response = @client.get("/threads/#{thread_id}/state", query_params)
+        Models::ThreadState.new(response)
+      end
+
+      def update_state(thread_id, **params)
+        body = compact_params(params)
+        @client.post("/threads/#{thread_id}/state", body)
+      end
+
+      def history(thread_id, **params)
+        params[:limit] ||= 10
+        query_params = compact_params(params)
+        response = @client.get("/threads/#{thread_id}/history", query_params)
+        response.map { |state_data| Models::ThreadState.new(state_data) }
+      end
+
+      def copy(thread_id)
+        response = @client.post("/threads/#{thread_id}/copy")
+        Models::Thread.new(response)
+      end
+    end
+  end
+end

data/lib/langgraph_platform/utils/paginator.rb

@@ -0,0 +1,60 @@
+module LanggraphPlatform
+  module Utils
+    class Paginator
+      include Enumerable
+
+      def initialize(resource, method, *args, **kwargs)
+        @resource = resource
+        @method = method
+        @args = args
+        @kwargs = kwargs
+        @limit = kwargs[:limit] || 10
+        @offset = kwargs[:offset] || 0
+      end
+
+      def each(&block)
+        return enum_for(:each) unless block_given?
+
+        current_offset = @offset
+
+        loop do
+          params = @kwargs.merge(limit: @limit, offset: current_offset)
+          results = @resource.send(@method, *@args, **params)
+
+          break if results.empty?
+
+          results.each(&block)
+
+          break if results.length < @limit
+
+          current_offset += @limit
+        end
+      end
+
+      def first(count = nil)
+        if count
+          take(count)
+        else
+          params = @kwargs.merge(limit: 1, offset: @offset)
+          results = @resource.send(@method, *@args, **params)
+          results.first
+        end
+      end
+
+      def page(page_number, per_page = @limit)
+        offset = (page_number - 1) * per_page
+        params = @kwargs.merge(limit: per_page, offset: offset)
+        @resource.send(@method, *@args, **params)
+      end
+
+      def count
+        # TODO: Implement count method
+        nil
+      end
+
+      def all
+        to_a
+      end
+    end
+  end
+end

data/lib/langgraph_platform/utils/validator.rb

@@ -0,0 +1,77 @@
+module LanggraphPlatform
+  module Utils
+    class Validator
+      def self.validate_required_params(params, required_keys)
+        missing_keys = required_keys - params.keys
+
+        return if missing_keys.empty?
+
+        raise ArgumentError, "Missing required parameters: #{missing_keys.join(', ')}"
+      end
+
+      def self.validate_param_types(params, type_map)
+        type_map.each do |key, expected_type|
+          value = params[key]
+          next if value.nil?
+
+          unless value.is_a?(expected_type)
+            raise ArgumentError, "Parameter '#{key}' must be of type #{expected_type}, got #{value.class}"
+          end
+        end
+      end
+
+      def self.validate_enum_values(params, enum_map)
+        enum_map.each do |key, allowed_values|
+          value = params[key]
+          next if value.nil?
+
+          unless allowed_values.include?(value)
+            raise ArgumentError, "Parameter '#{key}' must be one of #{allowed_values.join(', ')}, got '#{value}'"
+          end
+        end
+      end
+
+      def self.validate_assistant_id(assistant_id)
+        return unless assistant_id.nil? || assistant_id.to_s.strip.empty?
+
+        raise ArgumentError, 'Assistant ID cannot be nil or empty'
+      end
+
+      def self.validate_thread_id(thread_id)
+        return unless thread_id.nil? || thread_id.to_s.strip.empty?
+
+        raise ArgumentError, 'Thread ID cannot be nil or empty'
+      end
+
+      def self.validate_run_id(run_id)
+        return unless run_id.nil? || run_id.to_s.strip.empty?
+
+        raise ArgumentError, 'Run ID cannot be nil or empty'
+      end
+
+      def self.validate_cron_schedule(schedule)
+        raise ArgumentError, 'Cron schedule cannot be nil or empty' if schedule.nil? || schedule.to_s.strip.empty?
+
+        # Basic cron validation - should have 5 or 6 parts
+        parts = schedule.split(' ')
+        return if [5, 6].include?(parts.length)
+
+        raise ArgumentError, "Invalid cron schedule format. Expected 5 or 6 parts, got #{parts.length}"
+      end
+
+      def self.validate_pagination_params(limit, offset)
+        raise ArgumentError, 'Limit must be a positive integer' if limit && (!limit.is_a?(Integer) || limit < 1)
+
+        return unless offset && (!offset.is_a?(Integer) || offset.negative?)
+
+        raise ArgumentError, 'Offset must be a non-negative integer'
+      end
+
+      def self.validate_metadata(metadata)
+        return if metadata.is_a?(Hash)
+
+        raise ArgumentError, 'Metadata must be a Hash'
+      end
+    end
+  end
+end

data/lib/langgraph_platform/version.rb

@@ -0,0 +1,3 @@
+module LanggraphPlatform
+  VERSION = '0.1.0'.freeze
+end

data/lib/langgraph_platform.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'http'
+require 'multi_json'
+require 'ostruct'
+require 'time'
+require 'zeitwerk'
+require 'event_stream_parser'
+
+Zeitwerk::Loader.for_gem.setup
+
+module LanggraphPlatform
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification
+name: langgraph-platform
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Gys Muller
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-07-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: event_stream_parser
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+description: An unoffical Ruby SDK for interacting with LangGraph Platform APIs
+email:
+- gysmuller@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- lib/langgraph_platform.rb
+- lib/langgraph_platform/base_client.rb
+- lib/langgraph_platform/client.rb
+- lib/langgraph_platform/configuration.rb
+- lib/langgraph_platform/errors.rb
+- lib/langgraph_platform/models/assistant.rb
+- lib/langgraph_platform/models/checkpoint.rb
+- lib/langgraph_platform/models/cron.rb
+- lib/langgraph_platform/models/run.rb
+- lib/langgraph_platform/models/store_item.rb
+- lib/langgraph_platform/models/thread.rb
+- lib/langgraph_platform/models/thread_state.rb
+- lib/langgraph_platform/resources/assistants.rb
+- lib/langgraph_platform/resources/base_resource.rb
+- lib/langgraph_platform/resources/crons.rb
+- lib/langgraph_platform/resources/mcp.rb
+- lib/langgraph_platform/resources/runs.rb
+- lib/langgraph_platform/resources/store.rb
+- lib/langgraph_platform/resources/threads.rb
+- lib/langgraph_platform/utils/paginator.rb
+- lib/langgraph_platform/utils/validator.rb
+- lib/langgraph_platform/version.rb
+homepage: https://github.com/gysmuller/langgraph-platform
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.16
+signing_key:
+specification_version: 4
+summary: Ruby SDK for LangGraph Platform API
+test_files: []