feat(api): update via SDK Studio

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 106
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/llamastack%2Fllama-stack-client-fe0ae8a478adcaa69c96b9ee501073818e499700ce2ec66dd7f6eaf4c3fcf69c.yml
-openapi_spec_hash: 418d4a00c4676bbb2973b64a93484965
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/llamastack%2Fllama-stack-client-bb6596edeb9aa753145023f1950a340bc1701d5339b3fe7ea5d949fe6518f2c9.yml
+openapi_spec_hash: 2602f83d69df2cbde50321d06fa9ac9b
 config_hash: e6c3e48e220b264936ee6df8b996ab12

src/resources/agents/agents.ts

@@ -226,31 +226,58 @@ export interface ToolExecutionStep {
   started_at?: string;
 }
 
+/**
+ * Response from a tool invocation.
+ */
 export interface ToolResponse {
+  /**
+   * Unique identifier for the tool call this response is for
+   */
   call_id: string;
 
   /**
-   * A image content item
+   * The response content from the tool
    */
   content: Shared.InterleavedContent;
 
+  /**
+   * Name of the tool that was invoked
+   */
   tool_name: 'brave_search' | 'wolfram_alpha' | 'photogen' | 'code_interpreter' | (string & {});
 
+  /**
+   * (Optional) Additional metadata about the tool response
+   */
   metadata?: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
 }
 
+/**
+ * Response returned when creating a new agent.
+ */
 export interface AgentCreateResponse {
+  /**
+   * Unique identifier for the created agent
+   */
   agent_id: string;
 }
 
+/**
+ * An agent instance with configuration and metadata.
+ */
 export interface AgentRetrieveResponse {
   /**
-   * Configuration for an agent.
+   * Configuration settings for the agent
    */
   agent_config: Shared.AgentConfig;
 
+  /**
+   * Unique identifier for the agent
+   */
   agent_id: string;
 
+  /**
+   * Timestamp when the agent was created
+   */
   created_at: string;
 }
 

src/resources/agents/session.ts

@@ -74,16 +74,34 @@ export class SessionResource extends APIResource {
  * A single session of an interaction with an Agentic System.
  */
 export interface Session {
+  /**
+   * Unique identifier for the conversation session
+   */
   session_id: string;
 
+  /**
+   * Human-readable name for the session
+   */
   session_name: string;
 
+  /**
+   * Timestamp when the session was created
+   */
   started_at: string;
 
+  /**
+   * List of all turns that have occurred in this session
+   */
   turns: Array<TurnAPI.Turn>;
 }
 
+/**
+ * Response returned when creating a new agent session.
+ */
 export interface SessionCreateResponse {
+  /**
+   * Unique identifier for the created session
+   */
   session_id: string;
 }
 

src/resources/agents/steps.ts

@@ -22,9 +22,12 @@ export class Steps extends APIResource {
   }
 }
 
+/**
+ * Response containing details of a specific agent step.
+ */
 export interface StepRetrieveResponse {
   /**
-   * An inference step in an agent turn.
+   * The complete step data and execution details
    */
   step:
     | AgentsAPI.InferenceStep

src/resources/agents/turn.ts

@@ -98,38 +98,62 @@ export class TurnResource extends APIResource {
 }
 
 /**
- * streamed agent turn completion response.
+ * Streamed agent turn completion response.
  */
 export interface AgentTurnResponseStreamChunk {
+  /**
+   * Individual event in the agent turn response stream
+   */
   event: TurnResponseEvent;
 }
 
 /**
  * A single turn in an interaction with an Agentic System.
  */
 export interface Turn {
+  /**
+   * List of messages that initiated this turn
+   */
   input_messages: Array<Shared.UserMessage | Shared.ToolResponseMessage>;
 
   /**
-   * A message containing the model's (assistant) response in a chat conversation.
+   * The model's generated response containing content and metadata
    */
   output_message: Shared.CompletionMessage;
 
+  /**
+   * Unique identifier for the conversation session
+   */
   session_id: string;
 
+  /**
+   * Timestamp when the turn began
+   */
   started_at: string;
 
+  /**
+   * Ordered list of processing steps executed during this turn
+   */
   steps: Array<
     | AgentsAPI.InferenceStep
     | AgentsAPI.ToolExecutionStep
     | AgentsAPI.ShieldCallStep
     | AgentsAPI.MemoryRetrievalStep
   >;
 
+  /**
+   * Unique identifier for the turn within a session
+   */
   turn_id: string;
 
+  /**
+   * (Optional) Timestamp when the turn finished, if completed
+   */
   completed_at?: string;
 
+  /**
+   * (Optional) Files or media attached to the agent's response
+   */
   output_attachments?: Array<Turn.OutputAttachment>;
 }
 
@@ -193,6 +217,9 @@ export namespace Turn {
          * Note that URL could have length limits.
          */
         export interface URL {
+          /**
+           * The URL string pointing to the resource
+           */
           uri: string;
         }
       }
@@ -213,16 +240,31 @@ export namespace Turn {
       type: 'text';
     }
 
+    /**
+     * A URL reference to external content.
+     */
     export interface URL {
+      /**
+       * The URL string pointing to the resource
+       */
       uri: string;
     }
   }
 }
 
+/**
+ * An event in an agent turn response stream.
+ */
 export interface TurnResponseEvent {
+  /**
+   * Event-specific payload containing event data
+   */
   payload: TurnResponseEventPayload;
 }
 
+/**
+ * Payload for step start events in agent turn responses.
+ */
 export type TurnResponseEventPayload =
   | TurnResponseEventPayload.AgentTurnResponseStepStartPayload
   | TurnResponseEventPayload.AgentTurnResponseStepProgressPayload
@@ -232,72 +274,126 @@ export type TurnResponseEventPayload =
   | TurnResponseEventPayload.AgentTurnResponseTurnAwaitingInputPayload;
 
 export namespace TurnResponseEventPayload {
+  /**
+   * Payload for step start events in agent turn responses.
+   */
   export interface AgentTurnResponseStepStartPayload {
+    /**
+     * Type of event being reported
+     */
     event_type: 'step_start';
 
+    /**
+     * Unique identifier for the step within a turn
+     */
     step_id: string;
 
     /**
-     * Type of the step in an agent turn.
+     * Type of step being executed
      */
     step_type: 'inference' | 'tool_execution' | 'shield_call' | 'memory_retrieval';
 
+    /**
+     * (Optional) Additional metadata for the step
+     */
     metadata?: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
   }
 
+  /**
+   * Payload for step progress events in agent turn responses.
+   */
   export interface AgentTurnResponseStepProgressPayload {
+    /**
+     * Incremental content changes during step execution
+     */
     delta: Shared.ContentDelta;
 
+    /**
+     * Type of event being reported
+     */
     event_type: 'step_progress';
 
+    /**
+     * Unique identifier for the step within a turn
+     */
     step_id: string;
 
     /**
-     * Type of the step in an agent turn.
+     * Type of step being executed
      */
     step_type: 'inference' | 'tool_execution' | 'shield_call' | 'memory_retrieval';
   }
 
+  /**
+   * Payload for step completion events in agent turn responses.
+   */
   export interface AgentTurnResponseStepCompletePayload {
+    /**
+     * Type of event being reported
+     */
     event_type: 'step_complete';
 
     /**
-     * An inference step in an agent turn.
+     * Complete details of the executed step
      */
     step_details:
       | AgentsAPI.InferenceStep
       | AgentsAPI.ToolExecutionStep
       | AgentsAPI.ShieldCallStep
       | AgentsAPI.MemoryRetrievalStep;
 
+    /**
+     * Unique identifier for the step within a turn
+     */
     step_id: string;
 
     /**
-     * Type of the step in an agent turn.
+     * Type of step being executed
      */
     step_type: 'inference' | 'tool_execution' | 'shield_call' | 'memory_retrieval';
   }
 
+  /**
+   * Payload for turn start events in agent turn responses.
+   */
   export interface AgentTurnResponseTurnStartPayload {
+    /**
+     * Type of event being reported
+     */
     event_type: 'turn_start';
 
+    /**
+     * Unique identifier for the turn within a session
+     */
     turn_id: string;
   }
 
+  /**
+   * Payload for turn completion events in agent turn responses.
+   */
   export interface AgentTurnResponseTurnCompletePayload {
+    /**
+     * Type of event being reported
+     */
     event_type: 'turn_complete';
 
     /**
-     * A single turn in an interaction with an Agentic System.
+     * Complete turn data including all steps and results
      */
     turn: TurnAPI.Turn;
   }
 
+  /**
+   * Payload for turn awaiting input events in agent turn responses.
+   */
   export interface AgentTurnResponseTurnAwaitingInputPayload {
+    /**
+     * Type of event being reported
+     */
     event_type: 'turn_awaiting_input';
 
     /**
-     * A single turn in an interaction with an Agentic System.
+     * Turn data when waiting for external tool responses
      */
     turn: TurnAPI.Turn;
   }
@@ -395,6 +491,9 @@ export namespace TurnCreateParams {
          * Note that URL could have length limits.
          */
         export interface URL {
+          /**
+           * The URL string pointing to the resource
+           */
           uri: string;
         }
       }
@@ -415,7 +514,13 @@ export namespace TurnCreateParams {
       type: 'text';
     }
 
+    /**
+     * A URL reference to external content.
+     */
     export interface URL {
+      /**
+       * The URL string pointing to the resource
+       */
       uri: string;
     }
   }