temper-rb 0.5.4 → 0.6.1

data/lib/temper/generated/api/admin_ledger_api.rb

@@ -0,0 +1,98 @@
+=begin
+#Temper Cloud API
+
+#Knowledge base management API for temper cloud
+
+The version of the OpenAPI document: 0.6.1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'cgi'
+
+module Temper::Generated
+  class AdminLedgerApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Read the admin ledger
+    # Returns a page of recorded administrative acts, newest first, on exactly one axis. `subject` (`<kind>:<uuid>`, e.g. `kb_resources:<uuid>`) returns the acts performed on that subject, limited to the act families the caller may read about it: a system admin reads all of them, a caller who may administer grants on the subject reads its grant acts, and an owner or maintainer of a team (`kb_teams:<uuid>`) reads that team's membership changes (on the gating team, only a system admin does). `actor` returns the acts a profile performed: any caller may read their own, and only a system admin may read another's. A read the caller is not allowed is answered 404, not 403, so a refusal reveals nothing about the subject. `epoch` is when recording began; acts before it were not recorded. `limit` defaults to 50 and is capped at 200.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :subject Subject axis: &#x60;&lt;kind&gt;:&lt;uuid&gt;&#x60;, e.g. &#x60;kb_resources:0199c3f1-...&#x60;.
+    # @option opts [String] :actor Actor axis: whose acts to read. Reading your own is always allowed; reading another profile&#39;s requires a system admin.
+    # @option opts [Integer] :limit Page size: default 50, clamped to 1–200 rather than rejected.
+    # @option opts [Integer] :offset Page offset. Default 0.
+    # @option opts [String] :x_temper_surface The calling surface, for event-ledger attribution. Accepted values are &#x60;cli&#x60; and &#x60;sdk&#x60;; an absent or unrecognized value attributes the write to &#x60;web&#x60;. This is provenance, never authorization — an unrecognized value degrades, it never rejects.
+    # @return [AdminLedgerResponse]
+    def list_admin_ledger(opts = {})
+      data, _status_code, _headers = list_admin_ledger_with_http_info(opts)
+      data
+    end
+
+    # Read the admin ledger
+    # Returns a page of recorded administrative acts, newest first, on exactly one axis. &#x60;subject&#x60; (&#x60;&lt;kind&gt;:&lt;uuid&gt;&#x60;, e.g. &#x60;kb_resources:&lt;uuid&gt;&#x60;) returns the acts performed on that subject, limited to the act families the caller may read about it: a system admin reads all of them, a caller who may administer grants on the subject reads its grant acts, and an owner or maintainer of a team (&#x60;kb_teams:&lt;uuid&gt;&#x60;) reads that team&#39;s membership changes (on the gating team, only a system admin does). &#x60;actor&#x60; returns the acts a profile performed: any caller may read their own, and only a system admin may read another&#39;s. A read the caller is not allowed is answered 404, not 403, so a refusal reveals nothing about the subject. &#x60;epoch&#x60; is when recording began; acts before it were not recorded. &#x60;limit&#x60; defaults to 50 and is capped at 200.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :subject Subject axis: &#x60;&lt;kind&gt;:&lt;uuid&gt;&#x60;, e.g. &#x60;kb_resources:0199c3f1-...&#x60;.
+    # @option opts [String] :actor Actor axis: whose acts to read. Reading your own is always allowed; reading another profile&#39;s requires a system admin.
+    # @option opts [Integer] :limit Page size: default 50, clamped to 1–200 rather than rejected.
+    # @option opts [Integer] :offset Page offset. Default 0.
+    # @option opts [String] :x_temper_surface The calling surface, for event-ledger attribution. Accepted values are &#x60;cli&#x60; and &#x60;sdk&#x60;; an absent or unrecognized value attributes the write to &#x60;web&#x60;. This is provenance, never authorization — an unrecognized value degrades, it never rejects.
+    # @return [Array<(AdminLedgerResponse, Integer, Hash)>] AdminLedgerResponse data, response status code and response headers
+    def list_admin_ledger_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdminLedgerApi.list_admin_ledger ...'
+      end
+      allowable_values = ["cli", "sdk"]
+      if @api_client.config.client_side_validation && opts[:'x_temper_surface'] && !allowable_values.include?(opts[:'x_temper_surface'])
+        fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/admin/ledger'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'subject'] = opts[:'subject'] if !opts[:'subject'].nil?
+      query_params[:'actor'] = opts[:'actor'] if !opts[:'actor'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      header_params[:'X-Temper-Surface'] = opts[:'x_temper_surface'] if !opts[:'x_temper_surface'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AdminLedgerResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer_auth']
+
+      new_options = opts.merge(
+        :operation => :"AdminLedgerApi.list_admin_ledger",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdminLedgerApi#list_admin_ledger\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/temper/generated/api/auditor_api.rb

@@ -3,7 +3,7 @@
 
 #Knowledge base management API for temper cloud
 
-The version of the OpenAPI document: 0.5.4
+The version of the OpenAPI document: 0.6.1
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.23.0
@@ -185,7 +185,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/auditor/{cogmap}/complete'.sub('{cogmap}', CGI.escape(cogmap.to_s))
+      local_var_path = '/api/auditor/{cogmap}/complete'.sub('{cogmap}', CGI.escape(cogmap.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}

data/lib/temper/generated/api/blobs_api.rb

@@ -3,7 +3,7 @@
 
 #Knowledge base management API for temper cloud
 
-The version of the OpenAPI document: 0.5.4
+The version of the OpenAPI document: 0.6.1
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.23.0
@@ -59,7 +59,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/blobs/uploads/{id}/segments'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/blobs/uploads/{id}/segments'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -210,7 +210,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/blobs/{id}/relations'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/blobs/{id}/relations'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -280,7 +280,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/blobs/uploads/{id}'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/blobs/uploads/{id}'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -395,11 +395,11 @@ module Temper::Generated
     # @param [Hash] opts the optional parameters
     # @option opts [String] :invocation_id The invocation this act is correlated under (`kb_events.invocation_id`). Optional — a correlation aid, never a substitute for authn/authz.
     # @option opts [String] :correlation_id The act-grain thread this write belongs to (`kb_events.correlation_id`). Optional, caller- minted, provenance-only. Rides independently of `invocation_id` and of authorship.
-    # @option opts [String] :reasoning Free-text reasoning for the act. Authorship field — requires `confidence`.
+    # @option opts [String] :reasoning Free-text reasoning for the act. Authorship field — requires `confidence`. At most 16384 bytes.
     # @option opts [ConfidenceBand] :confidence Graded self-assessed confidence band. Required whenever any other authorship field is set.
-    # @option opts [String] :rationale Structured rationale for the act. Authorship field — requires `confidence`.
-    # @option opts [String] :persona The persona/role the author acted as. Authorship field — requires `confidence`.
-    # @option opts [String] :model The model that authored the act. Authorship field — requires `confidence`.
+    # @option opts [String] :rationale Structured rationale for the act. Authorship field — requires `confidence`. At most 16384 bytes.
+    # @option opts [String] :persona The persona/role the author acted as. Authorship field — requires `confidence`. At most 256 bytes.
+    # @option opts [String] :model The model that authored the act. Authorship field — requires `confidence`. At most 256 bytes.
     # @option opts [String] :x_temper_surface The calling surface, for event-ledger attribution. Accepted values are `cli` and `sdk`; an absent or unrecognized value attributes the write to `web`. This is provenance, never authorization — an unrecognized value degrades, it never rejects.
     # @return [BlobDeleteAck]
     def delete_blob(id, opts = {})
@@ -413,11 +413,11 @@ module Temper::Generated
     # @param [Hash] opts the optional parameters
     # @option opts [String] :invocation_id The invocation this act is correlated under (`kb_events.invocation_id`). Optional — a correlation aid, never a substitute for authn/authz.
     # @option opts [String] :correlation_id The act-grain thread this write belongs to (`kb_events.correlation_id`). Optional, caller- minted, provenance-only. Rides independently of `invocation_id` and of authorship.
-    # @option opts [String] :reasoning Free-text reasoning for the act. Authorship field — requires `confidence`.
+    # @option opts [String] :reasoning Free-text reasoning for the act. Authorship field — requires `confidence`. At most 16384 bytes.
     # @option opts [ConfidenceBand] :confidence Graded self-assessed confidence band. Required whenever any other authorship field is set.
-    # @option opts [String] :rationale Structured rationale for the act. Authorship field — requires `confidence`.
-    # @option opts [String] :persona The persona/role the author acted as. Authorship field — requires `confidence`.
-    # @option opts [String] :model The model that authored the act. Authorship field — requires `confidence`.
+    # @option opts [String] :rationale Structured rationale for the act. Authorship field — requires `confidence`. At most 16384 bytes.
+    # @option opts [String] :persona The persona/role the author acted as. Authorship field — requires `confidence`. At most 256 bytes.
+    # @option opts [String] :model The model that authored the act. Authorship field — requires `confidence`. At most 256 bytes.
     # @option opts [String] :x_temper_surface The calling surface, for event-ledger attribution. Accepted values are `cli` and `sdk`; an absent or unrecognized value attributes the write to `web`. This is provenance, never authorization — an unrecognized value degrades, it never rejects.
     # @return [Array<(BlobDeleteAck, Integer, Hash)>] BlobDeleteAck data, response status code and response headers
     def delete_blob_with_http_info(id, opts = {})
@@ -433,7 +433,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/blobs/{id}'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/blobs/{id}'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -516,7 +516,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/blobs/uploads/{id}/finalize'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/blobs/uploads/{id}/finalize'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -591,7 +591,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/blobs/{id}'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/blobs/{id}'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -737,7 +737,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/blobs/{id}/relations'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/blobs/{id}/relations'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}

data/lib/temper/generated/api/cognitive_maps_api.rb

@@ -3,7 +3,7 @@
 
 #Knowledge base management API for temper cloud
 
-The version of the OpenAPI document: 0.5.4
+The version of the OpenAPI document: 0.6.1
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.23.0
@@ -47,7 +47,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/cognitive-maps/{id}/analytics'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/cognitive-maps/{id}/analytics'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -121,7 +121,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/cognitive-maps/{id}/teams'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/cognitive-maps/{id}/teams'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -267,7 +267,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/cognitive-maps/{id}'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/cognitive-maps/{id}'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -341,7 +341,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/cognitive-maps/{id}/grants'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/cognitive-maps/{id}/grants'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -482,7 +482,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/cognitive-maps/{id}/materialize'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/cognitive-maps/{id}/materialize'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -557,7 +557,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/cognitive-maps/{id}/materialize-delta'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/cognitive-maps/{id}/materialize-delta'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -604,11 +604,11 @@ module Temper::Generated
     # @param [Hash] opts the optional parameters
     # @option opts [String] :invocation_id The invocation this act is correlated under (`kb_events.invocation_id`). Optional — a correlation aid, never a substitute for authn/authz.
     # @option opts [String] :correlation_id The act-grain thread this write belongs to (`kb_events.correlation_id`). Optional, caller- minted, provenance-only. Rides independently of `invocation_id` and of authorship.
-    # @option opts [String] :reasoning Free-text reasoning for the act. Authorship field — requires `confidence`.
+    # @option opts [String] :reasoning Free-text reasoning for the act. Authorship field — requires `confidence`. At most 16384 bytes.
     # @option opts [ConfidenceBand] :confidence Graded self-assessed confidence band. Required whenever any other authorship field is set.
-    # @option opts [String] :rationale Structured rationale for the act. Authorship field — requires `confidence`.
-    # @option opts [String] :persona The persona/role the author acted as. Authorship field — requires `confidence`.
-    # @option opts [String] :model The model that authored the act. Authorship field — requires `confidence`.
+    # @option opts [String] :rationale Structured rationale for the act. Authorship field — requires `confidence`. At most 16384 bytes.
+    # @option opts [String] :persona The persona/role the author acted as. Authorship field — requires `confidence`. At most 256 bytes.
+    # @option opts [String] :model The model that authored the act. Authorship field — requires `confidence`. At most 256 bytes.
     # @option opts [String] :x_temper_surface The calling surface, for event-ledger attribution. Accepted values are `cli` and `sdk`; an absent or unrecognized value attributes the write to `web`. This is provenance, never authorization — an unrecognized value degrades, it never rejects.
     # @return [ReconcileOutcome]
     def reconcile(id, reconcile_cogmap_request, opts = {})
@@ -622,11 +622,11 @@ module Temper::Generated
     # @param [Hash] opts the optional parameters
     # @option opts [String] :invocation_id The invocation this act is correlated under (`kb_events.invocation_id`). Optional — a correlation aid, never a substitute for authn/authz.
     # @option opts [String] :correlation_id The act-grain thread this write belongs to (`kb_events.correlation_id`). Optional, caller- minted, provenance-only. Rides independently of `invocation_id` and of authorship.
-    # @option opts [String] :reasoning Free-text reasoning for the act. Authorship field — requires `confidence`.
+    # @option opts [String] :reasoning Free-text reasoning for the act. Authorship field — requires `confidence`. At most 16384 bytes.
     # @option opts [ConfidenceBand] :confidence Graded self-assessed confidence band. Required whenever any other authorship field is set.
-    # @option opts [String] :rationale Structured rationale for the act. Authorship field — requires `confidence`.
-    # @option opts [String] :persona The persona/role the author acted as. Authorship field — requires `confidence`.
-    # @option opts [String] :model The model that authored the act. Authorship field — requires `confidence`.
+    # @option opts [String] :rationale Structured rationale for the act. Authorship field — requires `confidence`. At most 16384 bytes.
+    # @option opts [String] :persona The persona/role the author acted as. Authorship field — requires `confidence`. At most 256 bytes.
+    # @option opts [String] :model The model that authored the act. Authorship field — requires `confidence`. At most 256 bytes.
     # @option opts [String] :x_temper_surface The calling surface, for event-ledger attribution. Accepted values are `cli` and `sdk`; an absent or unrecognized value attributes the write to `web`. This is provenance, never authorization — an unrecognized value degrades, it never rejects.
     # @return [Array<(ReconcileOutcome, Integer, Hash)>] ReconcileOutcome data, response status code and response headers
     def reconcile_with_http_info(id, reconcile_cogmap_request, opts = {})
@@ -646,7 +646,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/cognitive-maps/{id}'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/cognitive-maps/{id}'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -728,7 +728,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/cognitive-maps/{id}/region-metrics'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/cognitive-maps/{id}/region-metrics'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -803,7 +803,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/cognitive-maps/{id}/grants'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/cognitive-maps/{id}/grants'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -878,7 +878,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/cognitive-maps/{id}/shape'.sub('{id}', CGI.escape(id.to_s))
+      local_var_path = '/api/cognitive-maps/{id}/shape'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -953,7 +953,7 @@ module Temper::Generated
         fail ArgumentError, "invalid value for \"x_temper_surface\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/cognitive-maps/{id}/teams/{team_id}'.sub('{id}', CGI.escape(id.to_s)).sub('{team_id}', CGI.escape(team_id.to_s))
+      local_var_path = '/api/cognitive-maps/{id}/teams/{team_id}'.sub('{id}', CGI.escape(id.to_s).gsub('.', '%2E')).sub('{team_id}', CGI.escape(team_id.to_s).gsub('.', '%2E'))
 
       # query parameters
       query_params = opts[:query_params] || {}