cadenya 0.52.0 → 1.0.1

data/lib/cadenya/client.rb

@@ -1,227 +1,72 @@
 # frozen_string_literal: true
 
-module Cadenya
-  class Client < Cadenya::Internal::Transport::BaseClient
-    # Default max number of retries to attempt after a failed retryable request.
-    DEFAULT_MAX_RETRIES = 0
-
-    # Default per-request timeout.
-    DEFAULT_TIMEOUT_IN_SECONDS = 60.0
-
-    # Default initial retry delay in seconds.
-    # Overall delay is calculated using exponential backoff + jitter.
-    DEFAULT_INITIAL_RETRY_DELAY = 0.5
-
-    # Default max retry delay in seconds.
-    DEFAULT_MAX_RETRY_DELAY = 8.0
-
-    # @return [String]
-    attr_reader :api_key
-
-    # @return [String, nil]
-    attr_reader :webhook_key
-
-    # Workspace to operate on. Fills the {workspaceId} path parameter on
-    # workspace-scoped endpoints unless overridden per request.
-    # @return [String, nil]
-    attr_reader :workspace_id
-
-    # @return [Cadenya::Resources::AIProviderKeys]
-    attr_reader :ai_provider_keys
-
-    # Manage the authenticated account. Accounts are the top-level organizational unit
-    # and contain one or more workspaces.
-    # @return [Cadenya::Resources::Account]
-    attr_reader :account
-
-    # Operations on profiles, the account-level principals (users, API keys, system)
-    # that authenticate against the API.
-    # @return [Cadenya::Resources::Profiles]
-    attr_reader :profiles
-
-    # Manage AI agents within a workspace. Agents define AI behavior and tool access.
-    # @return [Cadenya::Resources::Agents]
-    attr_reader :agents
-
-    # @return [Cadenya::Resources::Objectives]
-    attr_reader :objectives
-
-    # Manage memory layers and their entries. Layers are named containers that can be
-    # composed into an objective's memory cascade; entries are the keyed values within
-    # a layer. System-managed layers (e.g., episodic layers created by the runtime)
-    # cannot be mutated through this API.
-    # @return [Cadenya::Resources::MemoryLayers]
-    attr_reader :memory_layers
-
-    # Issue short-lived presigned URLs for direct client-to-object-storage uploads.
-    # Created uploads can be referenced by id when creating or updating resources that
-    # accept binary content (e.g., MemoryEntry).
-    # @return [Cadenya::Resources::Uploads]
-    attr_reader :uploads
-
-    # Manage LLM models available to a workspace. Models represent provider and family
-    # pairs (e.g., "anthropic/claude-sonnet-4.6"). Workspaces are seeded with the
-    # supported models and you can enable or disable each one.
-    # @return [Cadenya::Resources::Models]
-    attr_reader :models
-
-    # @return [Cadenya::Resources::Search]
-    attr_reader :search
-
-    # Manage tool sets and the tools they contain. Tool sets group related tools, and
-    # tools define specific capabilities available to agents.
-    #
-    # When a tool set is managed, only API key actors can modify its tools; human
-    # (profile) actors cannot.
-    # @return [Cadenya::Resources::ToolSets]
-    attr_reader :tool_sets
-
-    # Issue, rotate, disable, and revoke a workspace's API keys. Every key belongs to
-    # exactly one workspace; the system-managed global account key is managed via
-    # GlobalAPIKeyService instead.
-    # @return [Cadenya::Resources::APIKeys]
-    attr_reader :api_keys
-
-    # Manage the account's system-provisioned global API key. The global key is the
-    # only key that spans every workspace; it is created by the system and cannot be
-    # deleted, so the surface is retrieve, rotate, and the disable/enable kill switch.
-    # @return [Cadenya::Resources::GlobalAPIKey]
-    attr_reader :global_api_key
+# Code generated by redwood. DO NOT EDIT.
 
-    # @return [Cadenya::Resources::WorkspaceSecrets]
-    attr_reader :workspace_secrets
+require "json"
 
-    # Manage workspaces within an account. Workspaces provide organizational grouping
-    # and isolation for resources such as agents, tools, and API keys.
-    #
-    # This is the workspace-scoped, end-user surface. Administrative operations
-    # (create / archive workspaces, manage members) live in WorkspaceAdminService
-    # under /v1/account/workspaces and require the admin role.
-    # @return [Cadenya::Resources::Workspaces]
-    attr_reader :workspaces
-
-    # Administer workspaces across the account: create and archive workspaces and
-    # manage their membership. These operations are account-scoped and require the
-    # admin role (a token whose profile holds the WorkOS admin role); they live under
-    # /v1/account/workspaces rather than the workspace-scoped /v1/workspaces tree so
-    # an admin can manage any workspace in the account, including ones they are not
-    # themselves a member of.
-    # @return [Cadenya::Resources::WorkspaceAdmin]
-    attr_reader :workspace_admin
-
-    # @return [Cadenya::Resources::Webhooks]
-    attr_reader :webhooks
-
-    # Manage embeddable chat widgets. A widget binds an agent to a globally unique
-    # hostname with a per-widget origin allowlist; browsers reach it with session
-    # tokens minted via WidgetSessionService.
-    # @return [Cadenya::Resources::Widgets]
-    attr_reader :widgets
-
-    # Read and erase tenants and the subjects under them. Tenants and subjects are
-    # created by assertion — on objective creation or widget session mint — never
-    # directly, so this service has no create or update: it exists to enumerate what
-    # assertions have produced, and to destroy it on request.
-    # @return [Cadenya::Resources::Tenants]
-    attr_reader :tenants
-
-    # Mint and manage widget sessions. Session creation is server-to-server only: the
-    # customer's backend authenticates its visitor, asserts tenant/subject context,
-    # attaches any per-visitor secrets, and receives a short-lived bearer token the
-    # browser uses against the widget host.
-    # @return [Cadenya::Resources::WidgetSessions]
-    attr_reader :widget_sessions
-
-    # @api private
-    #
-    # @return [Hash{String=>String}]
-    private def auth_headers
-      return {} if @api_key.nil?
-
-      {"authorization" => "Bearer #{@api_key}"}
-    end
-
-    # Creates and returns a new client for interacting with the API.
-    #
-    # @param api_key [String, nil] Defaults to `ENV["CADENYA_API_KEY"]`
-    #
-    # @param workspace_id [String, nil] Workspace to operate on. Fills the {workspaceId} path parameter on
-    # workspace-scoped endpoints unless overridden per request. Defaults to
-    # `ENV["CADENYA_WORKSPACE_ID"]`
-    #
-    # @param webhook_key [String, nil] Defaults to `ENV["CADENYA_WEBHOOK_KEY"]`
-    #
-    # @param base_url [String, nil] Override the default base URL for the API, e.g.,
-    # `"https://api.example.com/v2/"`. Defaults to `ENV["CADENYA_BASE_URL"]`
-    #
-    # @param max_retries [Integer] Max number of retries to attempt after a failed retryable request.
-    #
-    # @param timeout [Float]
-    #
-    # @param initial_retry_delay [Float]
-    #
-    # @param max_retry_delay [Float]
-    def initialize(
-      api_key: ENV["CADENYA_API_KEY"],
-      workspace_id: ENV["CADENYA_WORKSPACE_ID"],
-      webhook_key: ENV["CADENYA_WEBHOOK_KEY"],
-      base_url: ENV["CADENYA_BASE_URL"],
-      max_retries: self.class::DEFAULT_MAX_RETRIES,
-      timeout: self.class::DEFAULT_TIMEOUT_IN_SECONDS,
-      initial_retry_delay: self.class::DEFAULT_INITIAL_RETRY_DELAY,
-      max_retry_delay: self.class::DEFAULT_MAX_RETRY_DELAY
-    )
-      base_url ||= "https://api.cadenya.com"
-
-      if api_key.nil?
-        raise ArgumentError.new("api_key is required, and can be set via environ: \"CADENYA_API_KEY\"")
+module Cadenya
+  # The Cadenya API client. Resource groups are readers; unset options are
+  # read from the environment.
+  class Client
+    attr_reader :accounts, :api_keys, :workspace_admin, :profiles, :workspaces, :agents, :ai_provider_keys, :memory_layers, :models, :objectives, :tool_search, :tenants, :tool_sets, :uploads, :widget_sessions, :widgets, :workspace_secrets
+
+    def initialize(api_key: nil, base_url: nil, webhook_secret: nil, max_retries: 0, connection: nil, stream_transport: nil, workspace_id: nil)
+      if !api_key.nil? && api_key.to_s.strip.empty?
+        raise ArgumentError, "api_key must not be blank"
       end
-
-      headers = {}
-      custom_headers_env = ENV["CADENYA_CUSTOM_HEADERS"]
-      unless custom_headers_env.nil?
-        parsed = {}
-        custom_headers_env.split("\n").each do |line|
-          colon = line.index(":")
-          unless colon.nil?
-            parsed[line[0...colon].strip] = line[(colon + 1)..].strip
-          end
-        end
-        headers = parsed.merge(headers)
+      if !base_url.nil? && base_url.to_s.strip.empty?
+        raise ArgumentError, "base_url must not be blank"
       end
-
-      @workspace_id = workspace_id&.to_s
-      @api_key = api_key.to_s
-      @webhook_key = webhook_key&.to_s
-
-      super(
+      if !webhook_secret.nil? && webhook_secret.to_s.strip.empty?
+        raise ArgumentError, "webhook_secret must not be blank"
+      end
+      if !workspace_id.nil? && workspace_id.to_s.strip.empty?
+        raise ArgumentError, "workspace_id must not be blank"
+      end
+      api_key = (api_key || ENV.fetch("CADENYA_API_KEY", "")).to_s.strip
+      if api_key.empty?
+        raise ArgumentError, "missing API key: pass api_key: or set CADENYA_API_KEY"
+      end
+      base_url = (base_url || ENV.fetch("CADENYA_BASE_URL", "")).to_s.strip
+      base_url = "https://api.cadenya.com" if base_url.empty?
+      @webhook_secret = (webhook_secret || ENV.fetch("CADENYA_WEBHOOK_SECRET", "")).to_s.strip
+      defaults = {}
+      defaults["workspaceId"] = (workspace_id || ENV.fetch("CADENYA_WORKSPACE_ID", "")).to_s.strip
+      core = Core.new(
         base_url: base_url,
-        timeout: timeout,
+        auth_header: ["Authorization", "Bearer #{api_key}"],
         max_retries: max_retries,
-        initial_retry_delay: initial_retry_delay,
-        max_retry_delay: max_retry_delay,
-        headers: headers
+        defaults: defaults,
+        user_agent: "cadenya-ruby/1.0.0 (api 1.0)",
+        connection: connection,
+        stream_transport: stream_transport
       )
+      @accounts = Resources::Accounts.new(core)
+      @api_keys = Resources::ApiKeys.new(core)
+      @workspace_admin = Resources::WorkspaceAdmin.new(core)
+      @profiles = Resources::Profiles.new(core)
+      @workspaces = Resources::Workspaces.new(core)
+      @agents = Resources::Agents.new(core)
+      @ai_provider_keys = Resources::AiProviderKeys.new(core)
+      @memory_layers = Resources::MemoryLayers.new(core)
+      @models = Resources::Models.new(core)
+      @objectives = Resources::Objectives.new(core)
+      @tool_search = Resources::ToolSearch.new(core)
+      @tenants = Resources::Tenants.new(core)
+      @tool_sets = Resources::ToolSets.new(core)
+      @uploads = Resources::Uploads.new(core)
+      @widget_sessions = Resources::WidgetSessions.new(core)
+      @widgets = Resources::Widgets.new(core)
+      @workspace_secrets = Resources::WorkspaceSecrets.new(core)
+    end
 
-      @ai_provider_keys = Cadenya::Resources::AIProviderKeys.new(client: self)
-      @account = Cadenya::Resources::Account.new(client: self)
-      @profiles = Cadenya::Resources::Profiles.new(client: self)
-      @agents = Cadenya::Resources::Agents.new(client: self)
-      @objectives = Cadenya::Resources::Objectives.new(client: self)
-      @memory_layers = Cadenya::Resources::MemoryLayers.new(client: self)
-      @uploads = Cadenya::Resources::Uploads.new(client: self)
-      @models = Cadenya::Resources::Models.new(client: self)
-      @search = Cadenya::Resources::Search.new(client: self)
-      @tool_sets = Cadenya::Resources::ToolSets.new(client: self)
-      @api_keys = Cadenya::Resources::APIKeys.new(client: self)
-      @global_api_key = Cadenya::Resources::GlobalAPIKey.new(client: self)
-      @workspace_secrets = Cadenya::Resources::WorkspaceSecrets.new(client: self)
-      @workspaces = Cadenya::Resources::Workspaces.new(client: self)
-      @workspace_admin = Cadenya::Resources::WorkspaceAdmin.new(client: self)
-      @webhooks = Cadenya::Resources::Webhooks.new(client: self)
-      @widgets = Cadenya::Resources::Widgets.new(client: self)
-      @tenants = Cadenya::Resources::Tenants.new(client: self)
-      @widget_sessions = Cadenya::Resources::WidgetSessions.new(client: self)
+    # Verify a Standard Webhooks delivery and return the typed payload.
+    def unwrap_webhook(payload, headers)
+      if @webhook_secret.to_s.empty?
+        raise ArgumentError, "missing webhook secret: pass webhook_secret: or set CADENYA_WEBHOOK_SECRET"
+      end
+      Webhooks.verify(@webhook_secret, payload, headers)
+      Types::ObjectiveEventWebhookData.from_json(JSON.parse(payload))
     end
   end
 end