driftgate-sdk 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7e9548e25eb817913f839fbf3fb79c281555fe93bbf5334a94ecc3547f322fce
+  data.tar.gz: 7c059174999ffa60dfe982e29980b4af2aa05e6b7762f4847f8a00db0f54fea5
+SHA512:
+  metadata.gz: d820734ab5c4359abd3788eee60da12c0b1e0820853a9b6e8a058abe758698e21656c63d7335465ddbff38f32c8a89d5403e32223349bda826a1ab9161e1ef98
+  data.tar.gz: 81c4ac11d3f14b53d5a9c3ba12d7dc7751392c4063a04287b4e3e6df25d4a452f6e89e2f4303415063a2197861cda9f75c62982b368af901bd3f48cd881639e7

data/README.md

@@ -0,0 +1,32 @@
+# DriftGate Ruby SDK
+
+Canonical V4 envelope SDK for Ruby.
+
+See canonical envelope docs: [`docs/sdk/response-envelope.md`](/Users/jordandavis/Documents/Code/DriftGateAI/driftgate-v4-sdk-wt/docs/sdk/response-envelope.md).
+
+## Install
+
+```bash
+gem install driftgate-sdk -v 0.1.0
+```
+
+## Hello World (2 lines)
+
+```ruby
+session = DriftGateSDK::Client.new(base_url: "https://api.driftgate.ai").session.start(agent: "refund-agent")
+session.execute(input: { orderId: "123" })
+```
+
+## Full Example
+
+```ruby
+client = DriftGateSDK::Client.new(base_url: "https://api.driftgate.ai", bearer_token: ENV.fetch("DRIFTGATE_TOKEN"))
+session = client.session.start(
+  agent: "refund-agent",
+  policy: { ref: "refund", version: "2026-02" },
+  route: { provider: "openai", model: "gpt-4.1-mini", region: "us-east-1" },
+  risk: { decision: "review" }
+)
+response = session.execute(input: { orderId: "123" })
+puts response.fetch("meta").fetch("requestId")
+```

data/lib/driftgate_sdk.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "uri"
+
+module DriftGateSDK
+  ERROR_CODES = %w[
+    AUTH_INVALID
+    POLICY_DENIED
+    RISK_EXCEEDED
+    ROUTE_UNAVAILABLE
+    TOOL_BLOCKED
+    RATE_LIMITED
+    TIMEOUT
+    INTERNAL
+  ].freeze
+
+  class Error < StandardError
+    attr_reader :code, :status, :retryable, :request_id, :details
+
+    def initialize(code:, message:, status:, retryable:, request_id: nil, details: nil)
+      super(message)
+      @code = code
+      @status = status
+      @retryable = retryable
+      @request_id = request_id
+      @details = details
+    end
+  end
+
+  class SessionHandle
+    attr_reader :session, :start_envelope
+
+    def initialize(client:, session:, start_envelope:)
+      @client = client
+      @session = session
+      @start_envelope = start_envelope
+    end
+
+    def session_id
+      @session.fetch("sessionId")
+    end
+
+    def execute(input:, policy: nil, route: nil, risk: nil, workflow_version_id: nil)
+      payload = { input: input }
+      payload[:policy] = policy if policy
+      payload[:route] = route if route
+      payload[:risk] = risk if risk
+      payload[:workflowVersionId] = workflow_version_id if workflow_version_id
+      @client.execute_session(session_id: session_id, payload: payload)
+    end
+  end
+
+  class Client
+    attr_accessor :api_key, :bearer_token
+
+    def initialize(base_url:, api_key: nil, bearer_token: nil, http: Net::HTTP)
+      @base_url = base_url.sub(%r{/$}, "")
+      @api_key = api_key
+      @bearer_token = bearer_token
+      @http = http
+    end
+
+    def session
+      self
+    end
+
+    def start(agent:, workspace_id: nil, subject: nil, metadata: nil, policy: nil, route: nil, risk: nil, workflow_version_id: nil, expires_at: nil)
+      payload = { agent: agent }
+      payload[:workspaceId] = workspace_id if workspace_id
+      payload[:subject] = subject if subject
+      payload[:metadata] = metadata if metadata
+      payload[:policy] = policy if policy
+      payload[:route] = route if route
+      payload[:risk] = risk if risk
+      payload[:workflowVersionId] = workflow_version_id if workflow_version_id
+      payload[:expiresAt] = expires_at if expires_at
+
+      envelope = request(method: "POST", path: "/v4/sessions.start", payload: payload)
+      raise_envelope_error(envelope) unless envelope.fetch("ok")
+
+      SessionHandle.new(client: self, session: envelope.fetch("data").fetch("session"), start_envelope: envelope)
+    end
+
+    def execute_session(session_id:, payload:)
+      envelope = request(method: "POST", path: "/v4/sessions/#{session_id}/executions.execute", payload: payload)
+      raise_envelope_error(envelope) unless envelope.fetch("ok")
+      envelope
+    end
+
+    def execute(agent:, input:, workspace_id: nil, subject: nil, metadata: nil, policy: nil, route: nil, risk: nil, workflow_version_id: nil)
+      payload = {
+        agent: agent,
+        input: input
+      }
+      payload[:workspaceId] = workspace_id if workspace_id
+      payload[:subject] = subject if subject
+      payload[:metadata] = metadata if metadata
+      payload[:policy] = policy if policy
+      payload[:route] = route if route
+      payload[:risk] = risk if risk
+      payload[:workflowVersionId] = workflow_version_id if workflow_version_id
+
+      envelope = request(method: "POST", path: "/v4/execute", payload: payload)
+      raise_envelope_error(envelope) unless envelope.fetch("ok")
+      envelope
+    end
+
+    private
+
+    def request(method:, path:, payload:)
+      uri = URI.parse("#{@base_url}#{path}")
+      request_class = Net::HTTP.const_get(method.capitalize)
+      request = request_class.new(uri)
+      request["content-type"] = "application/json"
+      request["x-driftgate-api-key"] = @api_key if @api_key
+      request["authorization"] = "Bearer #{@bearer_token}" if @bearer_token
+      request.body = JSON.generate(payload)
+
+      response = @http.start(uri.host, uri.port, use_ssl: uri.scheme == "https") do |http|
+        http.request(request)
+      end
+
+      body = response.body && !response.body.empty? ? JSON.parse(response.body) : {}
+      if response.code.to_i >= 400
+        raise_envelope_error(body)
+      end
+      body
+    end
+
+    def raise_envelope_error(payload)
+      if payload.is_a?(Hash) && payload["error"].is_a?(Hash)
+        error = payload["error"]
+        meta = payload["meta"].is_a?(Hash) ? payload["meta"] : {}
+        raise Error.new(
+          code: error.fetch("code", "INTERNAL"),
+          message: error.fetch("message", "request failed"),
+          status: error.fetch("status", 500),
+          retryable: error.fetch("retryable", false),
+          request_id: meta["requestId"],
+          details: error["details"]
+        )
+      end
+
+      raise Error.new(code: "INTERNAL", message: "request failed", status: 500, retryable: false)
+    end
+  end
+end

metadata

@@ -0,0 +1,48 @@
+--- !ruby/object:Gem::Specification
+name: driftgate-sdk
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- DriftGate
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-03-03 00:00:00.000000000 Z
+dependencies: []
+description: DriftGate Ruby SDK for canonical V4 session and execution APIs.
+email:
+- support@driftgate.ai
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/driftgate_sdk.rb
+homepage: https://docs.driftgate.ai
+licenses:
+- Apache-2.0
+metadata:
+  homepage_uri: https://docs.driftgate.ai
+  source_code_uri: https://github.com/driftgate/driftgate-sdk
+  changelog_uri: https://docs.driftgate.ai/changelog
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+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: DriftGate canonical V4 envelope SDK
+test_files: []