@specsage/cli 0.1.0

package/lib/step_client.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "uri"
+require "json"
+require "base64"
+
+class StepClient
+  class StepError < StandardError; end
+
+  attr_reader :server_run_id
+
+  def initialize(base_url:, server_run_id:, api_key: nil)
+    @base_url = base_url
+    @server_run_id = server_run_id
+    @api_key = api_key
+  end
+
+  # Upload video for a scenario
+  # video_data: binary video data
+  # scenario_id: the scenario this video belongs to
+  def upload_video(scenario_id:, video_data:)
+    return unless video_data
+
+    # Single request: send base64-encoded video, server stores file and creates record
+    post("/api/runs/#{@server_run_id}/video", {
+      scenario_id: scenario_id,
+      video_base64: Base64.strict_encode64(video_data)
+    })
+  end
+
+  # Set a verdict directly on the server (for client-side errors like step limit exceeded)
+  # status: "ERROR", "PASS", or "FAIL"
+  # reason: explanation string
+  def set_verdict(scenario_id:, status:, reason:)
+    post("/api/runs/#{@server_run_id}/step", {
+      scenario_id: scenario_id,
+      client_verdict: { status: status, reason: reason }
+    })
+  end
+
+  # Submit a step to the server
+  # Returns: { action: Hash, step_number: Integer, continue: Boolean }
+  def submit_step(scenario_id:, screenshot_base64:, elements:, previous_action: nil, action_result: nil)
+    body = {
+      scenario_id: scenario_id,
+      screenshot_base64: screenshot_base64,
+      elements: elements
+    }
+
+    body[:previous_action] = previous_action if previous_action
+    body[:action_result] = action_result if action_result
+
+    response = post("/api/runs/#{@server_run_id}/step", body)
+
+    {
+      action: response["action"],
+      step_number: response["step_number"],
+      max_steps: response["max_steps"],
+      continue: response["continue"],
+      credentials: response["credentials"] || {}
+    }
+  end
+
+  private
+
+  def post(path, body)
+    uri = URI.parse("#{@base_url}#{path}")
+    http = Net::HTTP.new(uri.host, uri.port)
+    http.use_ssl = uri.scheme == "https"
+    http.open_timeout = 10
+    http.read_timeout = 120  # LLM calls can take a while
+
+    request = Net::HTTP::Post.new(uri.request_uri)
+    request["Content-Type"] = "application/json"
+    request["Accept"] = "application/json"
+    request["Authorization"] = "Bearer #{@api_key}" if @api_key
+    request.body = body.to_json
+
+    response = http.request(request)
+    handle_response(response, path)
+  rescue Errno::ECONNREFUSED
+    raise StepError, "Could not connect to server at #{@base_url}"
+  rescue Net::ReadTimeout
+    raise StepError, "Server timeout - LLM may be taking too long"
+  end
+
+  def handle_response(response, path)
+    parsed = parse_response_body(response)
+
+    case response
+    when Net::HTTPSuccess
+      parsed
+    when Net::HTTPNotFound
+      raise StepError, "Not found: #{parsed['error'] || path}"
+    when Net::HTTPServiceUnavailable
+      raise StepError, "Service unavailable: #{parsed['error']}"
+    when Net::HTTPUnprocessableEntity
+      raise StepError, "Validation error: #{parsed['error']}"
+    else
+      raise StepError, "Server error #{response.code}: #{parsed['error'] || response.message}"
+    end
+  end
+
+  def parse_response_body(response)
+    body = response.body.to_s
+    content_type = response["Content-Type"].to_s
+
+    return {} if body.empty?
+
+    unless content_type.include?("application/json")
+      snippet = body.length > 200 ? "#{body[0, 200]}..." : body
+      raise StepError, "Expected JSON response but got #{content_type.inspect}: #{snippet}"
+    end
+
+    JSON.parse(body)
+  rescue JSON::ParserError => e
+    snippet = body.length > 200 ? "#{body[0, 200]}..." : body
+    raise StepError, "Invalid JSON response from server: #{e.message}. Body: #{snippet}"
+  end
+end

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@specsage/cli",
+  "version": "0.1.0",
+  "description": "SpecSage CLI - AI-powered end-to-end testing automation (Node wrapper for Ruby CLI)",
+  "type": "module",
+  "bin": {
+    "specsage": "./bin/specsage.js"
+  },
+  "files": [
+    "bin",
+    "lib"
+  ],
+  "scripts": {
+    "test": "node --test"
+  },
+  "keywords": [
+    "testing",
+    "e2e",
+    "automation",
+    "playwright",
+    "ai"
+  ],
+  "author": "SpecSage",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/specsage/specsage.git",
+    "directory": "packages/cli"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}