cadenya 0.49.0 → 0.50.0

data/rbi/cadenya/resources/memory_layers/entries.rbi

@@ -13,9 +13,13 @@ module Cadenya
         sig do
           params(
             memory_layer_id: String,
-            workspace_id: String,
             metadata: Cadenya::CreateResourceMetadata::OrHash,
-            spec: Cadenya::MemoryLayers::MemoryEntryCreateSpec::OrHash,
+            spec:
+              T.any(
+                Cadenya::MemoryLayers::MemoryEntryCreateSpecContent::OrHash,
+                Cadenya::MemoryLayers::MemoryEntryCreateSpecUploadID::OrHash
+              ),
+            workspace_id: String,
             request_options: Cadenya::RequestOptions::OrHash
           ).returns(Cadenya::MemoryLayers::MemoryEntryDetail)
         end
@@ -23,8 +27,6 @@ module Cadenya
           # Path param: Memory layer ID. Accepts canonical memlyr\_… form or
           # external_id:<value> form.
           memory_layer_id,
-          # Path param
-          workspace_id:,
           # Body param: CreateResourceMetadata contains the user-provided fields for
           # creating a workspace-scoped resource. Read-only fields (id, account_id,
           # workspace_id, profile_id, created_at) are excluded since they are set by the
@@ -34,6 +36,8 @@ module Cadenya
           # accepts either inline content or a reference to a completed Upload; exactly one
           # of the two must be set.
           spec:,
+          # Path param
+          workspace_id: nil,
           request_options: {}
         )
         end
@@ -42,17 +46,17 @@ module Cadenya
         # including the content body.
         sig do
           params(
+            memory_layer_id: String,
             id: String,
             workspace_id: String,
-            memory_layer_id: String,
             request_options: Cadenya::RequestOptions::OrHash
           ).returns(Cadenya::MemoryLayers::MemoryEntryDetail)
         end
         def retrieve(
-          id,
-          workspace_id:,
           # Memory layer ID. Accepts canonical memlyr\_… form or external_id:<value> form.
-          memory_layer_id:,
+          memory_layer_id,
+          id,
+          workspace_id: nil,
           request_options: {}
         )
         end
@@ -61,9 +65,9 @@ module Cadenya
         # resolved content body.
         sig do
           params(
+            memory_layer_id: String,
             id: String,
             workspace_id: String,
-            memory_layer_id: String,
             metadata: Cadenya::UpdateResourceMetadata::OrHash,
             spec: Cadenya::MemoryLayers::MemoryEntryUpdateSpec::OrHash,
             update_mask: String,
@@ -71,13 +75,13 @@ module Cadenya
           ).returns(Cadenya::MemoryLayers::MemoryEntryDetail)
         end
         def update(
+          # Path param: Memory layer ID. Accepts canonical memlyr\_… form or
+          # external_id:<value> form.
+          memory_layer_id,
           # Path param
           id,
           # Path param
-          workspace_id:,
-          # Path param: Memory layer ID. Accepts canonical memlyr\_… form or
-          # external_id:<value> form.
-          memory_layer_id:,
+          workspace_id: nil,
           # Body param: UpdateResourceMetadata contains the user-provided fields for
           # updating a workspace-scoped resource. Read-only fields (id, account_id,
           # workspace_id, profile_id, created_at) are excluded since they are set by the
@@ -118,7 +122,7 @@ module Cadenya
           # external_id:<value> form.
           memory_layer_id,
           # Path param
-          workspace_id:,
+          workspace_id: nil,
           # Query param: Pagination cursor from previous response
           cursor: nil,
           # Query param: When set to true you may use more of your alloted API rate-limit
@@ -143,17 +147,17 @@ module Cadenya
         # Deletes a memory entry from a memory layer
         sig do
           params(
+            memory_layer_id: String,
             id: String,
             workspace_id: String,
-            memory_layer_id: String,
             request_options: Cadenya::RequestOptions::OrHash
           ).void
         end
         def delete(
-          id,
-          workspace_id:,
           # Memory layer ID. Accepts canonical memlyr\_… form or external_id:<value> form.
-          memory_layer_id:,
+          memory_layer_id,
+          id,
+          workspace_id: nil,
           request_options: {}
         )
         end

data/rbi/cadenya/resources/memory_layers.rbi

@@ -17,19 +17,22 @@ module Cadenya
       # Creates a new memory layer in the workspace
       sig do
         params(
-          workspace_id: String,
           metadata: Cadenya::CreateResourceMetadata::OrHash,
           spec: Cadenya::MemoryLayerSpec::OrHash,
+          workspace_id: String,
           request_options: Cadenya::RequestOptions::OrHash
         ).returns(Cadenya::MemoryLayer)
       end
       def create(
-        workspace_id,
-        # CreateResourceMetadata contains the user-provided fields for creating a
-        # workspace-scoped resource. Read-only fields (id, account_id, workspace_id,
-        # profile_id, created_at) are excluded since they are set by the server.
+        # Body param: CreateResourceMetadata contains the user-provided fields for
+        # creating a workspace-scoped resource. Read-only fields (id, account_id,
+        # workspace_id, profile_id, created_at) are excluded since they are set by the
+        # server.
         metadata:,
+        # Body param
         spec:,
+        # Path param
+        workspace_id: nil,
         request_options: {}
       )
       end
@@ -45,7 +48,7 @@ module Cadenya
       def retrieve(
         # Memory layer ID. Accepts canonical memlyr\_… form or external_id:<value> form.
         id,
-        workspace_id:,
+        workspace_id: nil,
         request_options: {}
       )
       end
@@ -66,7 +69,7 @@ module Cadenya
         # external_id:<value> form.
         id,
         # Path param
-        workspace_id:,
+        workspace_id: nil,
         # Body param: UpdateResourceMetadata contains the user-provided fields for
         # updating a workspace-scoped resource. Read-only fields (id, account_id,
         # workspace_id, profile_id, created_at) are excluded since they are set by the
@@ -98,30 +101,31 @@ module Cadenya
         ).returns(Cadenya::Internal::CursorPagination[Cadenya::MemoryLayer])
       end
       def list(
-        workspace_id,
-        # Filter to episodic layers belonging to this agent.
+        # Path param
+        workspace_id: nil,
+        # Query param: Filter to episodic layers belonging to this agent.
         agent_id: nil,
-        # Pagination cursor from previous response
+        # Query param: Pagination cursor from previous response
         cursor: nil,
-        # Filter to episodic layers whose episodic key starts with this prefix (e.g.
-        # "customer/" matches "customer/42" and "customer/43"). Useful for namespaced
-        # keys, similar to a redis key scan.
+        # Query param: Filter to episodic layers whose episodic key starts with this
+        # prefix (e.g. "customer/" matches "customer/42" and "customer/43"). Useful for
+        # namespaced keys, similar to a redis key scan.
         episodic_key_prefix: nil,
-        # When set to true you may use more of your alloted API rate-limit
+        # Query param: When set to true you may use more of your alloted API rate-limit
         include_info: nil,
-        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # Query param: Filters by metadata labels. Comma-separated key=value pairs, e.g.
         # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
         # semantics).
         labels: nil,
-        # Maximum number of results to return
+        # Query param: Maximum number of results to return
         limit: nil,
-        # Filter expression (query param: prefix)
+        # Query param: Filter expression (query param: prefix)
         prefix: nil,
-        # Free-form search query
+        # Query param: Free-form search query
         query: nil,
-        # Sort order for results (asc or desc by creation time)
+        # Query param: Sort order for results (asc or desc by creation time)
         sort_order: nil,
-        # Filter by layer type
+        # Query param: Filter by layer type
         type: nil,
         request_options: {}
       )
@@ -138,7 +142,7 @@ module Cadenya
       def delete(
         # Memory layer ID. Accepts canonical memlyr\_… form or external_id:<value> form.
         id,
-        workspace_id:,
+        workspace_id: nil,
         request_options: {}
       )
       end

data/rbi/cadenya/resources/models.rbi

@@ -18,7 +18,7 @@ module Cadenya
         # Model ID
         id,
         # Workspace ID.
-        workspace_id:,
+        workspace_id: nil,
         request_options: {}
       )
       end
@@ -41,35 +41,35 @@ module Cadenya
         ).returns(Cadenya::Internal::CursorPagination[Cadenya::Model])
       end
       def list(
-        # Workspace ID.
-        workspace_id,
-        # Filter to models provisioned on a specific AI provider key. Accepts the key's id
-        # or an "external_id:"-prefixed slug.
+        # Path param: Workspace ID.
+        workspace_id: nil,
+        # Query param: Filter to models provisioned on a specific AI provider key. Accepts
+        # the key's id or an "external_id:"-prefixed slug.
         ai_provider_key_id: nil,
-        # Pagination cursor from previous response
+        # Query param: Pagination cursor from previous response
         cursor: nil,
-        # When true, populate each item's info (e.g. the AI provider), at the cost of
-        # extra lookups.
+        # Query param: When true, populate each item's info (e.g. the AI provider), at the
+        # cost of extra lookups.
         include_info: nil,
-        # Filter models to only ones assigned to an active agent variation/agent. Draft
-        # agents count as assigned; archived agents do not. Assignment does not imply
-        # recent traffic — see ModelInfo.last_used_at for that.
+        # Query param: Filter models to only ones assigned to an active agent
+        # variation/agent. Draft agents count as assigned; archived agents do not.
+        # Assignment does not imply recent traffic — see ModelInfo.last_used_at for that.
         is_assigned: nil,
-        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # Query param: Filters by metadata labels. Comma-separated key=value pairs, e.g.
         # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
         # semantics).
         labels: nil,
-        # Maximum number of results to return
+        # Query param: Maximum number of results to return
         limit: nil,
-        # Filter by a prefix of the model's display name, external id, or id
+        # Query param: Filter by a prefix of the model's display name, external id, or id
         # (case-insensitive). A model's external id is the form used in
         # modelConfig.modelId, so a caller holding that can narrow the list by it.
         prefix: nil,
-        # Free-form search query
+        # Query param: Free-form search query
         query: nil,
-        # Sort order for results (asc or desc by creation time)
+        # Query param: Sort order for results (asc or desc by creation time)
         sort_order: nil,
-        # Filter by model state
+        # Query param: Filter by model state
         state: nil,
         request_options: {}
       )
@@ -88,7 +88,7 @@ module Cadenya
         # Model ID
         id,
         # Workspace ID.
-        workspace_id:,
+        workspace_id: nil,
         request_options: {}
       )
       end
@@ -106,7 +106,7 @@ module Cadenya
         # Model ID
         id,
         # Workspace ID.
-        workspace_id:,
+        workspace_id: nil,
         request_options: {}
       )
       end
@@ -121,9 +121,9 @@ module Cadenya
         ).returns(T.anything)
       end
       def swap(
-        # Workspace ID.
-        workspace_id,
-        # The swaps to perform.
+        # Path param: Workspace ID.
+        workspace_id: nil,
+        # Body param: The swaps to perform.
         model_swaps: nil,
         request_options: {}
       )

data/rbi/cadenya/resources/objectives/feedback.rbi

@@ -9,9 +9,9 @@ module Cadenya
         sig do
           params(
             objective_id: String,
-            workspace_id: String,
             data: Cadenya::Objectives::ObjectiveFeedbackData::OrHash,
             metadata: Cadenya::CreateOperationMetadata::OrHash,
+            workspace_id: String,
             request_options: Cadenya::RequestOptions::OrHash
           ).returns(Cadenya::Objectives::ObjectiveFeedback)
         end
@@ -19,14 +19,14 @@ module Cadenya
           # Path param: The ID of the objective. Supports "external_id:" prefix for external
           # IDs.
           objective_id,
-          # Path param
-          workspace_id:,
           # Body param
           data:,
           # Body param: CreateOperationMetadata contains the user-provided fields for
           # creating an operation. Read-only fields (id, account_id, workspace_id,
           # created_at, profile_id) are excluded since they are set by the server.
           metadata:,
+          # Path param
+          workspace_id: nil,
           request_options: {}
         )
         end
@@ -51,7 +51,7 @@ module Cadenya
           # IDs.
           objective_id,
           # Path param
-          workspace_id:,
+          workspace_id: nil,
           # Query param: Pagination cursor from previous response
           cursor: nil,
           # Query param: Filters by metadata labels. Comma-separated key=value pairs, e.g.

data/rbi/cadenya/resources/objectives/tasks.rbi

@@ -7,18 +7,18 @@ module Cadenya
         # Retrieves a task by ID from an objective
         sig do
           params(
+            objective_id: String,
             id: String,
             workspace_id: String,
-            objective_id: String,
             request_options: Cadenya::RequestOptions::OrHash
           ).returns(Cadenya::Objectives::ObjectiveTask)
         end
         def retrieve(
+          # The ID of the objective. Supports "external_id:" prefix for external IDs.
+          objective_id,
           # Task ID
           id,
-          workspace_id:,
-          # The ID of the objective. Supports "external_id:" prefix for external IDs.
-          objective_id:,
+          workspace_id: nil,
           request_options: {}
         )
         end
@@ -43,7 +43,7 @@ module Cadenya
           # IDs.
           objective_id,
           # Path param
-          workspace_id:,
+          workspace_id: nil,
           # Query param: Pagination cursor from previous response
           cursor: nil,
           # Query param: Maximum number of results to return

data/rbi/cadenya/resources/objectives/tool_calls.rbi

@@ -8,18 +8,18 @@ module Cadenya
         # content (images, audio) is served as short-lived signed URLs.
         sig do
           params(
+            objective_id: String,
             tool_call_id: String,
             workspace_id: String,
-            objective_id: String,
             request_options: Cadenya::RequestOptions::OrHash
           ).returns(Cadenya::Objectives::ObjectiveToolCallWithResult)
         end
         def retrieve(
+          # The ID of the objective. Supports "external_id:" prefix for external IDs.
+          objective_id,
           # The ID of the tool call to retrieve
           tool_call_id,
-          workspace_id:,
-          # The ID of the objective. Supports "external_id:" prefix for external IDs.
-          objective_id:,
+          workspace_id: nil,
           request_options: {}
         )
         end
@@ -47,7 +47,7 @@ module Cadenya
           # Path param: The objective ID to return tool calls for
           objective_id,
           # Path param
-          workspace_id:,
+          workspace_id: nil,
           # Query param: Pagination cursor from previous response
           cursor: nil,
           # Query param: Filter by tool call execution status. Useful for reverse-harness
@@ -72,18 +72,18 @@ module Cadenya
         # to mark it as approved.
         sig do
           params(
+            objective_id: String,
             tool_call_id: String,
             workspace_id: String,
-            objective_id: String,
             request_options: Cadenya::RequestOptions::OrHash
           ).returns(Cadenya::Objectives::ObjectiveToolCall)
         end
         def approve(
+          # The ID of the objective. Supports "external_id:" prefix for external IDs.
+          objective_id,
           # The ID of the tool call to approve
           tool_call_id,
-          workspace_id:,
-          # The ID of the objective. Supports "external_id:" prefix for external IDs.
-          objective_id:,
+          workspace_id: nil,
           request_options: {}
         )
         end
@@ -93,21 +93,21 @@ module Cadenya
         # usage of the tool.
         sig do
           params(
+            objective_id: String,
             tool_call_id: String,
             workspace_id: String,
-            objective_id: String,
             memo: String,
             request_options: Cadenya::RequestOptions::OrHash
           ).returns(Cadenya::Objectives::ObjectiveToolCall)
         end
         def deny(
+          # Path param: The ID of the objective. Supports "external_id:" prefix for external
+          # IDs.
+          objective_id,
           # Path param: The ID of the tool call to deny
           tool_call_id,
           # Path param
-          workspace_id:,
-          # Path param: The ID of the objective. Supports "external_id:" prefix for external
-          # IDs.
-          objective_id:,
+          workspace_id: nil,
           # Body param: A memo to associate to the tool call denial. Use a memo to steer the
           # LLM to a different decision or usage of the tool.
           memo: nil,
@@ -120,28 +120,32 @@ module Cadenya
         # and reverse harnesses that execute tools locally and report results back.
         sig do
           params(
-            tool_call_id: String,
-            workspace_id: String,
             objective_id: String,
+            tool_call_id: String,
             content:
               T::Array[
-                Cadenya::Objectives::SetToolCallContentRequestContentBlock::OrHash
+                T.any(
+                  Cadenya::Objectives::SetToolCallContentRequestContentBlockText::OrHash,
+                  Cadenya::Objectives::SetToolCallContentRequestContentBlockImage::OrHash,
+                  Cadenya::Objectives::SetToolCallContentRequestContentBlockAudio::OrHash
+                )
               ],
+            workspace_id: String,
             request_options: Cadenya::RequestOptions::OrHash
           ).returns(Cadenya::Objectives::ObjectiveToolCall)
         end
         def set_content(
-          # Path param: The ID of the tool call to set content for
-          tool_call_id,
-          # Path param
-          workspace_id:,
           # Path param: The ID of the objective. Supports "external_id:" prefix for external
           # IDs.
-          objective_id:,
+          objective_id,
+          # Path param: The ID of the tool call to set content for
+          tool_call_id,
           # Body param: The content to set on the tool call. Mirrors
           # ObjectiveToolCallResult.ContentBlock but writable: media blocks carry raw data
           # on input where the result-side carries a signed url on output.
           content:,
+          # Path param
+          workspace_id: nil,
           request_options: {}
         )
         end

data/rbi/cadenya/resources/objectives/tools.rbi

@@ -23,7 +23,7 @@ module Cadenya
           # IDs.
           objective_id,
           # Path param
-          workspace_id:,
+          workspace_id: nil,
           # Query param: Pagination cursor from previous response
           cursor: nil,
           # Query param: Maximum number of results to return