@spaciv/sdk 0.1.17 → 0.1.18

package/dist/esm/models/AssistantChatPollBody.js

@@ -26,6 +26,10 @@ export function instanceOfAssistantChatPollBody(value) {
         return false;
     if (!('status' in value) || value['status'] === undefined)
         return false;
+    if (!('subsessionSteps' in value) || value['subsessionSteps'] === undefined)
+        return false;
+    if (!('subsessionTool' in value) || value['subsessionTool'] === undefined)
+        return false;
     return true;
 }
 export function AssistantChatPollBodyFromJSON(json) {
@@ -41,6 +45,8 @@ export function AssistantChatPollBodyFromJSONTyped(json, ignoreDiscriminator) {
         'finishedToolCallIds': json['finishedToolCallIds'],
         'messages': (json['messages'].map(AssistantChatPollMessageFromJSON)),
         'status': json['status'],
+        'subsessionSteps': json['subsessionSteps'],
+        'subsessionTool': json['subsessionTool'],
     };
 }
 export function AssistantChatPollBodyToJSON(json) {
@@ -56,5 +62,7 @@ export function AssistantChatPollBodyToJSONTyped(value, ignoreDiscriminator = fa
         'finishedToolCallIds': value['finishedToolCallIds'],
         'messages': (value['messages'].map(AssistantChatPollMessageToJSON)),
         'status': value['status'],
+        'subsessionSteps': value['subsessionSteps'],
+        'subsessionTool': value['subsessionTool'],
     };
 }

package/dist/esm/models/AssistantChatPollMessage.d.ts

@@ -58,6 +58,12 @@ export interface AssistantChatPollMessage {
      * @memberof AssistantChatPollMessage
      */
     role: string;
+    /**
+     * Id of the conversation a run_subsession action message (kind 2) started, which is polled like any other conversation to follow the subsession's own steps. It is not found until the subsession has started. Empty on every other message.
+     * @type {string}
+     * @memberof AssistantChatPollMessage
+     */
+    subsessionId: string;
     /**
      *
      * @type {string}

package/dist/esm/models/AssistantChatPollMessage.js

@@ -30,6 +30,8 @@ export function instanceOfAssistantChatPollMessage(value) {
         return false;
     if (!('role' in value) || value['role'] === undefined)
         return false;
+    if (!('subsessionId' in value) || value['subsessionId'] === undefined)
+        return false;
     if (!('text' in value) || value['text'] === undefined)
         return false;
     if (!('toolCallId' in value) || value['toolCallId'] === undefined)
@@ -51,6 +53,7 @@ export function AssistantChatPollMessageFromJSONTyped(json, ignoreDiscriminator)
         'payload': json['payload'],
         'requestId': json['requestId'],
         'role': json['role'],
+        'subsessionId': json['subsessionId'],
         'text': json['text'],
         'toolCallId': json['toolCallId'],
     };
@@ -70,6 +73,7 @@ export function AssistantChatPollMessageToJSONTyped(value, ignoreDiscriminator =
         'payload': value['payload'],
         'requestId': value['requestId'],
         'role': value['role'],
+        'subsessionId': value['subsessionId'],
         'text': value['text'],
         'toolCallId': value['toolCallId'],
     };

package/dist/esm/models/AssistantTranscriptBody.d.ts

@@ -16,12 +16,30 @@ import type { AssistantTranscriptMessage } from './AssistantTranscriptMessage';
  * @interface AssistantTranscriptBody
  */
 export interface AssistantTranscriptBody {
+    /**
+     *
+     * @type {string}
+     * @memberof AssistantTranscriptBody
+     */
+    conversationId: string;
     /**
      *
      * @type {Array<AssistantTranscriptMessage>}
      * @memberof AssistantTranscriptBody
      */
     messages: Array<AssistantTranscriptMessage>;
+    /**
+     * For a subsession, the id of the run_subsession tool call that started it. Empty for a conversation the user started.
+     * @type {string}
+     * @memberof AssistantTranscriptBody
+     */
+    parentToolCallId: string;
+    /**
+     * The transcript of each subsession the assistant started, in the order it started them. A subsession's messages are not part of messages: the tool message answering its run_subsession call holds only its reply. A subsession is never compacted and starts none of its own, so its summary fields and its own subsessions are empty.
+     * @type {Array<AssistantTranscriptBody>}
+     * @memberof AssistantTranscriptBody
+     */
+    subsessions: Array<AssistantTranscriptBody>;
     /**
      * What the assistant is told of the messages it no longer replays, once the conversation has been compacted. Empty until then.
      * @type {string}

package/dist/esm/models/AssistantTranscriptBody.js

@@ -16,8 +16,14 @@ import { AssistantTranscriptMessageFromJSON, AssistantTranscriptMessageToJSON, }
  * Check if a given object implements the AssistantTranscriptBody interface.
  */
 export function instanceOfAssistantTranscriptBody(value) {
+    if (!('conversationId' in value) || value['conversationId'] === undefined)
+        return false;
     if (!('messages' in value) || value['messages'] === undefined)
         return false;
+    if (!('parentToolCallId' in value) || value['parentToolCallId'] === undefined)
+        return false;
+    if (!('subsessions' in value) || value['subsessions'] === undefined)
+        return false;
     if (!('summary' in value) || value['summary'] === undefined)
         return false;
     if (!('summaryUpTo' in value) || value['summaryUpTo'] === undefined)
@@ -32,7 +38,10 @@ export function AssistantTranscriptBodyFromJSONTyped(json, ignoreDiscriminator)
         return json;
     }
     return {
+        'conversationId': json['conversationId'],
         'messages': (json['messages'].map(AssistantTranscriptMessageFromJSON)),
+        'parentToolCallId': json['parentToolCallId'],
+        'subsessions': (json['subsessions'].map(AssistantTranscriptBodyFromJSON)),
         'summary': json['summary'],
         'summaryUpTo': json['summaryUpTo'],
     };
@@ -45,7 +54,10 @@ export function AssistantTranscriptBodyToJSONTyped(value, ignoreDiscriminator =
         return value;
     }
     return {
+        'conversationId': value['conversationId'],
         'messages': (value['messages'].map(AssistantTranscriptMessageToJSON)),
+        'parentToolCallId': value['parentToolCallId'],
+        'subsessions': (value['subsessions'].map(AssistantTranscriptBodyToJSON)),
         'summary': value['summary'],
         'summaryUpTo': value['summaryUpTo'],
     };

package/dist/models/AssistantChatPollBody.d.ts

@@ -48,6 +48,18 @@ export interface AssistantChatPollBody {
      * @memberof AssistantChatPollBody
      */
     status: string;
+    /**
+     * While a subsession is running, how many messages it has recorded so far, which grows with each of its steps even when it calls the same tool again. Zero when no subsession is running, including once it has ended and before the turn has recorded its result.
+     * @type {number}
+     * @memberof AssistantChatPollBody
+     */
+    subsessionSteps: number;
+    /**
+     * While a subsession is running, the tool it is running now. Empty while it is thinking, and when no subsession is running. The running subsession is the run_subsession action whose toolCallId is not yet among the finished tool calls.
+     * @type {string}
+     * @memberof AssistantChatPollBody
+     */
+    subsessionTool: string;
 }
 /**
  * Check if a given object implements the AssistantChatPollBody interface.

package/dist/models/AssistantChatPollBody.js

@@ -33,6 +33,10 @@ function instanceOfAssistantChatPollBody(value) {
         return false;
     if (!('status' in value) || value['status'] === undefined)
         return false;
+    if (!('subsessionSteps' in value) || value['subsessionSteps'] === undefined)
+        return false;
+    if (!('subsessionTool' in value) || value['subsessionTool'] === undefined)
+        return false;
     return true;
 }
 function AssistantChatPollBodyFromJSON(json) {
@@ -48,6 +52,8 @@ function AssistantChatPollBodyFromJSONTyped(json, ignoreDiscriminator) {
         'finishedToolCallIds': json['finishedToolCallIds'],
         'messages': (json['messages'].map(AssistantChatPollMessage_1.AssistantChatPollMessageFromJSON)),
         'status': json['status'],
+        'subsessionSteps': json['subsessionSteps'],
+        'subsessionTool': json['subsessionTool'],
     };
 }
 function AssistantChatPollBodyToJSON(json) {
@@ -63,5 +69,7 @@ function AssistantChatPollBodyToJSONTyped(value, ignoreDiscriminator = false) {
         'finishedToolCallIds': value['finishedToolCallIds'],
         'messages': (value['messages'].map(AssistantChatPollMessage_1.AssistantChatPollMessageToJSON)),
         'status': value['status'],
+        'subsessionSteps': value['subsessionSteps'],
+        'subsessionTool': value['subsessionTool'],
     };
 }

package/dist/models/AssistantChatPollMessage.d.ts

@@ -58,6 +58,12 @@ export interface AssistantChatPollMessage {
      * @memberof AssistantChatPollMessage
      */
     role: string;
+    /**
+     * Id of the conversation a run_subsession action message (kind 2) started, which is polled like any other conversation to follow the subsession's own steps. It is not found until the subsession has started. Empty on every other message.
+     * @type {string}
+     * @memberof AssistantChatPollMessage
+     */
+    subsessionId: string;
     /**
      *
      * @type {string}

package/dist/models/AssistantChatPollMessage.js

@@ -37,6 +37,8 @@ function instanceOfAssistantChatPollMessage(value) {
         return false;
     if (!('role' in value) || value['role'] === undefined)
         return false;
+    if (!('subsessionId' in value) || value['subsessionId'] === undefined)
+        return false;
     if (!('text' in value) || value['text'] === undefined)
         return false;
     if (!('toolCallId' in value) || value['toolCallId'] === undefined)
@@ -58,6 +60,7 @@ function AssistantChatPollMessageFromJSONTyped(json, ignoreDiscriminator) {
         'payload': json['payload'],
         'requestId': json['requestId'],
         'role': json['role'],
+        'subsessionId': json['subsessionId'],
         'text': json['text'],
         'toolCallId': json['toolCallId'],
     };
@@ -77,6 +80,7 @@ function AssistantChatPollMessageToJSONTyped(value, ignoreDiscriminator = false)
         'payload': value['payload'],
         'requestId': value['requestId'],
         'role': value['role'],
+        'subsessionId': value['subsessionId'],
         'text': value['text'],
         'toolCallId': value['toolCallId'],
     };

package/dist/models/AssistantTranscriptBody.d.ts

@@ -16,12 +16,30 @@ import type { AssistantTranscriptMessage } from './AssistantTranscriptMessage';
  * @interface AssistantTranscriptBody
  */
 export interface AssistantTranscriptBody {
+    /**
+     *
+     * @type {string}
+     * @memberof AssistantTranscriptBody
+     */
+    conversationId: string;
     /**
      *
      * @type {Array<AssistantTranscriptMessage>}
      * @memberof AssistantTranscriptBody
      */
     messages: Array<AssistantTranscriptMessage>;
+    /**
+     * For a subsession, the id of the run_subsession tool call that started it. Empty for a conversation the user started.
+     * @type {string}
+     * @memberof AssistantTranscriptBody
+     */
+    parentToolCallId: string;
+    /**
+     * The transcript of each subsession the assistant started, in the order it started them. A subsession's messages are not part of messages: the tool message answering its run_subsession call holds only its reply. A subsession is never compacted and starts none of its own, so its summary fields and its own subsessions are empty.
+     * @type {Array<AssistantTranscriptBody>}
+     * @memberof AssistantTranscriptBody
+     */
+    subsessions: Array<AssistantTranscriptBody>;
     /**
      * What the assistant is told of the messages it no longer replays, once the conversation has been compacted. Empty until then.
      * @type {string}

package/dist/models/AssistantTranscriptBody.js

@@ -23,8 +23,14 @@ const AssistantTranscriptMessage_1 = require("./AssistantTranscriptMessage");
  * Check if a given object implements the AssistantTranscriptBody interface.
  */
 function instanceOfAssistantTranscriptBody(value) {
+    if (!('conversationId' in value) || value['conversationId'] === undefined)
+        return false;
     if (!('messages' in value) || value['messages'] === undefined)
         return false;
+    if (!('parentToolCallId' in value) || value['parentToolCallId'] === undefined)
+        return false;
+    if (!('subsessions' in value) || value['subsessions'] === undefined)
+        return false;
     if (!('summary' in value) || value['summary'] === undefined)
         return false;
     if (!('summaryUpTo' in value) || value['summaryUpTo'] === undefined)
@@ -39,7 +45,10 @@ function AssistantTranscriptBodyFromJSONTyped(json, ignoreDiscriminator) {
         return json;
     }
     return {
+        'conversationId': json['conversationId'],
         'messages': (json['messages'].map(AssistantTranscriptMessage_1.AssistantTranscriptMessageFromJSON)),
+        'parentToolCallId': json['parentToolCallId'],
+        'subsessions': (json['subsessions'].map(AssistantTranscriptBodyFromJSON)),
         'summary': json['summary'],
         'summaryUpTo': json['summaryUpTo'],
     };
@@ -52,7 +61,10 @@ function AssistantTranscriptBodyToJSONTyped(value, ignoreDiscriminator = false)
         return value;
     }
     return {
+        'conversationId': value['conversationId'],
         'messages': (value['messages'].map(AssistantTranscriptMessage_1.AssistantTranscriptMessageToJSON)),
+        'parentToolCallId': value['parentToolCallId'],
+        'subsessions': (value['subsessions'].map(AssistantTranscriptBodyToJSON)),
         'summary': value['summary'],
         'summaryUpTo': value['summaryUpTo'],
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spaciv/sdk",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "OpenAPI client for @spaciv/sdk",
   "author": "OpenAPI-Generator",
   "repository": {

package/src/apis/AssistantApi.ts

@@ -79,7 +79,7 @@ export interface AssistantApiUpdateConfigRequest {
  */
 export interface AssistantApiInterface {
     /**
-     * Submits a message to the assistant and dispatches it for asynchronous processing. Returns a `conversationId` and a `requestId` immediately; the reply arrives out-of-band, through `GET /v1/assistant/conversations/{id}/poll`. If `conversationId` is omitted a new conversation is started. `attachmentFileIds` attaches up to 10 distinct files from account file storage and requires View file storage permission. Files cannot be attached while the account has turned the assistant\'s tools off. Requires the *AI assistant* permission.
+     * Submits a message to the assistant and dispatches it for asynchronous processing. Returns a `conversationId` and a `requestId` immediately; the reply arrives out-of-band, through `GET /v1/assistant/conversations/{id}/poll`. If `conversationId` is omitted a new conversation is started. `attachmentFileIds` attaches up to 10 distinct files from account file storage and requires View file storage permission. Files cannot be attached while the account has turned the assistant\'s tools off. Returns `409` if `conversationId` names a conversation that cannot take messages: a subsession the assistant started for a tool call, which only ever answers the task it was given, or a deleted conversation. Requires the *AI assistant* permission.
      * @summary Send a chat message
      * @param {AssistantChatReq} [assistantChatReq] 
      * @param {*} [options] Override http request option.
@@ -89,13 +89,13 @@ export interface AssistantApiInterface {
     createChatRaw(requestParameters: AssistantApiCreateChatRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AssistantChatRes>>;
 
     /**
-     * Submits a message to the assistant and dispatches it for asynchronous processing. Returns a `conversationId` and a `requestId` immediately; the reply arrives out-of-band, through `GET /v1/assistant/conversations/{id}/poll`. If `conversationId` is omitted a new conversation is started. `attachmentFileIds` attaches up to 10 distinct files from account file storage and requires View file storage permission. Files cannot be attached while the account has turned the assistant\'s tools off. Requires the *AI assistant* permission.
+     * Submits a message to the assistant and dispatches it for asynchronous processing. Returns a `conversationId` and a `requestId` immediately; the reply arrives out-of-band, through `GET /v1/assistant/conversations/{id}/poll`. If `conversationId` is omitted a new conversation is started. `attachmentFileIds` attaches up to 10 distinct files from account file storage and requires View file storage permission. Files cannot be attached while the account has turned the assistant\'s tools off. Returns `409` if `conversationId` names a conversation that cannot take messages: a subsession the assistant started for a tool call, which only ever answers the task it was given, or a deleted conversation. Requires the *AI assistant* permission.
      * Send a chat message
      */
     createChat(requestParameters: AssistantApiCreateChatRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AssistantChatRes>;
 
     /**
-     * Permanently removes a conversation and all its messages. Returns `404` if the conversation does not exist. Requires the *AI assistant* permission.
+     * Permanently removes a conversation, all its messages, and every subsession it started. Returns `404` if the conversation does not exist, and `409` if it is a subsession, which is deleted only with the conversation that started it. Requires the *AI assistant* permission.
      * @summary Delete a conversation
      * @param {string} id UUID of the conversation to delete.
      * @param {*} [options] Override http request option.
@@ -105,7 +105,7 @@ export interface AssistantApiInterface {
     deleteConversationsRaw(requestParameters: AssistantApiDeleteConversationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
 
     /**
-     * Permanently removes a conversation and all its messages. Returns `404` if the conversation does not exist. Requires the *AI assistant* permission.
+     * Permanently removes a conversation, all its messages, and every subsession it started. Returns `404` if the conversation does not exist, and `409` if it is a subsession, which is deleted only with the conversation that started it. Requires the *AI assistant* permission.
      * Delete a conversation
      */
     deleteConversations(requestParameters: AssistantApiDeleteConversationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
@@ -126,7 +126,7 @@ export interface AssistantApiInterface {
     getConfig(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AssistantConfigBody>;
 
     /**
-     * Returns the conversation as it is stored, for debugging and evaluating the assistant: every message the assistant has been shown, including the results of its tool calls and the ids that pair each result with its call, and the summary that replaces the earliest messages once the conversation has been compacted. Returns `404` if the conversation does not exist. Requires the *AI assistant* and *Download AI assistant conversation* permissions.
+     * Returns the conversation as it is stored, for debugging and evaluating the assistant: every message the assistant has been shown, including the results of its tool calls and the ids that pair each result with its call, the summary that replaces the earliest messages once the conversation has been compacted, and the stored conversation of every subsession the assistant handed a task to. Returns `404` if the conversation does not exist. Requires the *AI assistant* and *Download AI assistant conversation* permissions.
      * @summary Get a conversation\'s transcript
      * @param {string} id UUID of the conversation to read.
      * @param {*} [options] Override http request option.
@@ -136,7 +136,7 @@ export interface AssistantApiInterface {
     getConversationsTranscriptRaw(requestParameters: AssistantApiGetConversationsTranscriptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AssistantTranscriptBody>>;
 
     /**
-     * Returns the conversation as it is stored, for debugging and evaluating the assistant: every message the assistant has been shown, including the results of its tool calls and the ids that pair each result with its call, and the summary that replaces the earliest messages once the conversation has been compacted. Returns `404` if the conversation does not exist. Requires the *AI assistant* and *Download AI assistant conversation* permissions.
+     * Returns the conversation as it is stored, for debugging and evaluating the assistant: every message the assistant has been shown, including the results of its tool calls and the ids that pair each result with its call, the summary that replaces the earliest messages once the conversation has been compacted, and the stored conversation of every subsession the assistant handed a task to. Returns `404` if the conversation does not exist. Requires the *AI assistant* and *Download AI assistant conversation* permissions.
      * Get a conversation\'s transcript
      */
     getConversationsTranscript(requestParameters: AssistantApiGetConversationsTranscriptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AssistantTranscriptBody>;
@@ -189,7 +189,7 @@ export interface AssistantApiInterface {
     pollConversations(requestParameters: AssistantApiPollConversationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AssistantChatPollBody>;
 
     /**
-     * Asks the assistant to stop the turn it is working on. The turn ends at its next step - a tool call already sent finishes and is recorded - so the conversation stays usable and keeps everything the turn did before it was stopped. Succeeds with nothing to do if no turn is running. Returns `404` if the conversation does not exist. Requires the *AI assistant* permission.
+     * Asks the assistant to stop the turn it is working on. The turn ends at its next step - a tool call already sent finishes and is recorded - so the conversation stays usable and keeps everything the turn did before it was stopped. Succeeds with nothing to do if no turn is running. Stopping a conversation also stops a subsession it is running. Returns `404` if the conversation does not exist, and `409` if it is a subsession, which is stopped only by stopping the conversation that started it. Requires the *AI assistant* permission.
      * @summary Stop the running turn
      * @param {string} id UUID of the conversation whose turn to stop.
      * @param {*} [options] Override http request option.
@@ -199,7 +199,7 @@ export interface AssistantApiInterface {
     stopConversationsRaw(requestParameters: AssistantApiStopConversationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
 
     /**
-     * Asks the assistant to stop the turn it is working on. The turn ends at its next step - a tool call already sent finishes and is recorded - so the conversation stays usable and keeps everything the turn did before it was stopped. Succeeds with nothing to do if no turn is running. Returns `404` if the conversation does not exist. Requires the *AI assistant* permission.
+     * Asks the assistant to stop the turn it is working on. The turn ends at its next step - a tool call already sent finishes and is recorded - so the conversation stays usable and keeps everything the turn did before it was stopped. Succeeds with nothing to do if no turn is running. Stopping a conversation also stops a subsession it is running. Returns `404` if the conversation does not exist, and `409` if it is a subsession, which is stopped only by stopping the conversation that started it. Requires the *AI assistant* permission.
      * Stop the running turn
      */
     stopConversations(requestParameters: AssistantApiStopConversationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
@@ -228,7 +228,7 @@ export interface AssistantApiInterface {
 export class AssistantApi extends runtime.BaseAPI implements AssistantApiInterface {
 
     /**
-     * Submits a message to the assistant and dispatches it for asynchronous processing. Returns a `conversationId` and a `requestId` immediately; the reply arrives out-of-band, through `GET /v1/assistant/conversations/{id}/poll`. If `conversationId` is omitted a new conversation is started. `attachmentFileIds` attaches up to 10 distinct files from account file storage and requires View file storage permission. Files cannot be attached while the account has turned the assistant\'s tools off. Requires the *AI assistant* permission.
+     * Submits a message to the assistant and dispatches it for asynchronous processing. Returns a `conversationId` and a `requestId` immediately; the reply arrives out-of-band, through `GET /v1/assistant/conversations/{id}/poll`. If `conversationId` is omitted a new conversation is started. `attachmentFileIds` attaches up to 10 distinct files from account file storage and requires View file storage permission. Files cannot be attached while the account has turned the assistant\'s tools off. Returns `409` if `conversationId` names a conversation that cannot take messages: a subsession the assistant started for a tool call, which only ever answers the task it was given, or a deleted conversation. Requires the *AI assistant* permission.
      * Send a chat message
      */
     async createChatRaw(requestParameters: AssistantApiCreateChatRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AssistantChatRes>> {
@@ -261,7 +261,7 @@ export class AssistantApi extends runtime.BaseAPI implements AssistantApiInterfa
     }
 
     /**
-     * Submits a message to the assistant and dispatches it for asynchronous processing. Returns a `conversationId` and a `requestId` immediately; the reply arrives out-of-band, through `GET /v1/assistant/conversations/{id}/poll`. If `conversationId` is omitted a new conversation is started. `attachmentFileIds` attaches up to 10 distinct files from account file storage and requires View file storage permission. Files cannot be attached while the account has turned the assistant\'s tools off. Requires the *AI assistant* permission.
+     * Submits a message to the assistant and dispatches it for asynchronous processing. Returns a `conversationId` and a `requestId` immediately; the reply arrives out-of-band, through `GET /v1/assistant/conversations/{id}/poll`. If `conversationId` is omitted a new conversation is started. `attachmentFileIds` attaches up to 10 distinct files from account file storage and requires View file storage permission. Files cannot be attached while the account has turned the assistant\'s tools off. Returns `409` if `conversationId` names a conversation that cannot take messages: a subsession the assistant started for a tool call, which only ever answers the task it was given, or a deleted conversation. Requires the *AI assistant* permission.
      * Send a chat message
      */
     async createChat(requestParameters: AssistantApiCreateChatRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AssistantChatRes> {
@@ -270,7 +270,7 @@ export class AssistantApi extends runtime.BaseAPI implements AssistantApiInterfa
     }
 
     /**
-     * Permanently removes a conversation and all its messages. Returns `404` if the conversation does not exist. Requires the *AI assistant* permission.
+     * Permanently removes a conversation, all its messages, and every subsession it started. Returns `404` if the conversation does not exist, and `409` if it is a subsession, which is deleted only with the conversation that started it. Requires the *AI assistant* permission.
      * Delete a conversation
      */
     async deleteConversationsRaw(requestParameters: AssistantApiDeleteConversationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
@@ -308,7 +308,7 @@ export class AssistantApi extends runtime.BaseAPI implements AssistantApiInterfa
     }
 
     /**
-     * Permanently removes a conversation and all its messages. Returns `404` if the conversation does not exist. Requires the *AI assistant* permission.
+     * Permanently removes a conversation, all its messages, and every subsession it started. Returns `404` if the conversation does not exist, and `409` if it is a subsession, which is deleted only with the conversation that started it. Requires the *AI assistant* permission.
      * Delete a conversation
      */
     async deleteConversations(requestParameters: AssistantApiDeleteConversationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
@@ -355,7 +355,7 @@ export class AssistantApi extends runtime.BaseAPI implements AssistantApiInterfa
     }
 
     /**
-     * Returns the conversation as it is stored, for debugging and evaluating the assistant: every message the assistant has been shown, including the results of its tool calls and the ids that pair each result with its call, and the summary that replaces the earliest messages once the conversation has been compacted. Returns `404` if the conversation does not exist. Requires the *AI assistant* and *Download AI assistant conversation* permissions.
+     * Returns the conversation as it is stored, for debugging and evaluating the assistant: every message the assistant has been shown, including the results of its tool calls and the ids that pair each result with its call, the summary that replaces the earliest messages once the conversation has been compacted, and the stored conversation of every subsession the assistant handed a task to. Returns `404` if the conversation does not exist. Requires the *AI assistant* and *Download AI assistant conversation* permissions.
      * Get a conversation\'s transcript
      */
     async getConversationsTranscriptRaw(requestParameters: AssistantApiGetConversationsTranscriptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AssistantTranscriptBody>> {
@@ -393,7 +393,7 @@ export class AssistantApi extends runtime.BaseAPI implements AssistantApiInterfa
     }
 
     /**
-     * Returns the conversation as it is stored, for debugging and evaluating the assistant: every message the assistant has been shown, including the results of its tool calls and the ids that pair each result with its call, and the summary that replaces the earliest messages once the conversation has been compacted. Returns `404` if the conversation does not exist. Requires the *AI assistant* and *Download AI assistant conversation* permissions.
+     * Returns the conversation as it is stored, for debugging and evaluating the assistant: every message the assistant has been shown, including the results of its tool calls and the ids that pair each result with its call, the summary that replaces the earliest messages once the conversation has been compacted, and the stored conversation of every subsession the assistant handed a task to. Returns `404` if the conversation does not exist. Requires the *AI assistant* and *Download AI assistant conversation* permissions.
      * Get a conversation\'s transcript
      */
     async getConversationsTranscript(requestParameters: AssistantApiGetConversationsTranscriptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AssistantTranscriptBody> {
@@ -531,7 +531,7 @@ export class AssistantApi extends runtime.BaseAPI implements AssistantApiInterfa
     }
 
     /**
-     * Asks the assistant to stop the turn it is working on. The turn ends at its next step - a tool call already sent finishes and is recorded - so the conversation stays usable and keeps everything the turn did before it was stopped. Succeeds with nothing to do if no turn is running. Returns `404` if the conversation does not exist. Requires the *AI assistant* permission.
+     * Asks the assistant to stop the turn it is working on. The turn ends at its next step - a tool call already sent finishes and is recorded - so the conversation stays usable and keeps everything the turn did before it was stopped. Succeeds with nothing to do if no turn is running. Stopping a conversation also stops a subsession it is running. Returns `404` if the conversation does not exist, and `409` if it is a subsession, which is stopped only by stopping the conversation that started it. Requires the *AI assistant* permission.
      * Stop the running turn
      */
     async stopConversationsRaw(requestParameters: AssistantApiStopConversationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
@@ -569,7 +569,7 @@ export class AssistantApi extends runtime.BaseAPI implements AssistantApiInterfa
     }
 
     /**
-     * Asks the assistant to stop the turn it is working on. The turn ends at its next step - a tool call already sent finishes and is recorded - so the conversation stays usable and keeps everything the turn did before it was stopped. Succeeds with nothing to do if no turn is running. Returns `404` if the conversation does not exist. Requires the *AI assistant* permission.
+     * Asks the assistant to stop the turn it is working on. The turn ends at its next step - a tool call already sent finishes and is recorded - so the conversation stays usable and keeps everything the turn did before it was stopped. Succeeds with nothing to do if no turn is running. Stopping a conversation also stops a subsession it is running. Returns `404` if the conversation does not exist, and `409` if it is a subsession, which is stopped only by stopping the conversation that started it. Requires the *AI assistant* permission.
      * Stop the running turn
      */
     async stopConversations(requestParameters: AssistantApiStopConversationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {

package/src/apis/ScenariosApi.ts

@@ -167,7 +167,7 @@ export interface ScenariosApiInterface {
     listLayerVariables(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<LayerVariablesRes>;
 
     /**
-     * Updates the name, description, colour, and/or layers of the specified scenario. Only non-nil fields in the request body are applied. `hexCode` is a colour such as `#1f77b4` or `#abc`; an empty string clears it. A non-empty `layers` replaces the stored layers and `clearLayers` removes them all; sending both returns `400`. Returns `400` if the colour is not a valid hex code or a newly referenced layer points at an entity that does not exist. Requires the *Edit scenario planning* permission.
+     * Updates the name, description, colour, and/or layers of the specified scenario. Only non-nil fields in the request body are applied. `hexCode` is a colour such as `#1f77b4` or `#abc`; an empty string clears it. A non-empty `layers` replaces the stored layers and `clearLayers` removes them all; sending both returns `400`. Returns `400` if the colour is not a valid hex code or a newly referenced layer points at an entity that does not exist. Returns `409` if the scenario keeps changing concurrently while the update is retried. Requires the *Edit scenario planning* permission.
      * @summary Update a scenario
      * @param {string} id 
      * @param {ScenarioPatch} [scenarioPatch] 
@@ -178,7 +178,7 @@ export interface ScenariosApiInterface {
     updateRaw(requestParameters: ScenariosApiUpdateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>>;
 
     /**
-     * Updates the name, description, colour, and/or layers of the specified scenario. Only non-nil fields in the request body are applied. `hexCode` is a colour such as `#1f77b4` or `#abc`; an empty string clears it. A non-empty `layers` replaces the stored layers and `clearLayers` removes them all; sending both returns `400`. Returns `400` if the colour is not a valid hex code or a newly referenced layer points at an entity that does not exist. Requires the *Edit scenario planning* permission.
+     * Updates the name, description, colour, and/or layers of the specified scenario. Only non-nil fields in the request body are applied. `hexCode` is a colour such as `#1f77b4` or `#abc`; an empty string clears it. A non-empty `layers` replaces the stored layers and `clearLayers` removes them all; sending both returns `400`. Returns `400` if the colour is not a valid hex code or a newly referenced layer points at an entity that does not exist. Returns `409` if the scenario keeps changing concurrently while the update is retried. Requires the *Edit scenario planning* permission.
      * Update a scenario
      */
     update(requestParameters: ScenariosApiUpdateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object>;
@@ -468,7 +468,7 @@ export class ScenariosApi extends runtime.BaseAPI implements ScenariosApiInterfa
     }
 
     /**
-     * Updates the name, description, colour, and/or layers of the specified scenario. Only non-nil fields in the request body are applied. `hexCode` is a colour such as `#1f77b4` or `#abc`; an empty string clears it. A non-empty `layers` replaces the stored layers and `clearLayers` removes them all; sending both returns `400`. Returns `400` if the colour is not a valid hex code or a newly referenced layer points at an entity that does not exist. Requires the *Edit scenario planning* permission.
+     * Updates the name, description, colour, and/or layers of the specified scenario. Only non-nil fields in the request body are applied. `hexCode` is a colour such as `#1f77b4` or `#abc`; an empty string clears it. A non-empty `layers` replaces the stored layers and `clearLayers` removes them all; sending both returns `400`. Returns `400` if the colour is not a valid hex code or a newly referenced layer points at an entity that does not exist. Returns `409` if the scenario keeps changing concurrently while the update is retried. Requires the *Edit scenario planning* permission.
      * Update a scenario
      */
     async updateRaw(requestParameters: ScenariosApiUpdateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>> {
@@ -509,7 +509,7 @@ export class ScenariosApi extends runtime.BaseAPI implements ScenariosApiInterfa
     }
 
     /**
-     * Updates the name, description, colour, and/or layers of the specified scenario. Only non-nil fields in the request body are applied. `hexCode` is a colour such as `#1f77b4` or `#abc`; an empty string clears it. A non-empty `layers` replaces the stored layers and `clearLayers` removes them all; sending both returns `400`. Returns `400` if the colour is not a valid hex code or a newly referenced layer points at an entity that does not exist. Requires the *Edit scenario planning* permission.
+     * Updates the name, description, colour, and/or layers of the specified scenario. Only non-nil fields in the request body are applied. `hexCode` is a colour such as `#1f77b4` or `#abc`; an empty string clears it. A non-empty `layers` replaces the stored layers and `clearLayers` removes them all; sending both returns `400`. Returns `400` if the colour is not a valid hex code or a newly referenced layer points at an entity that does not exist. Returns `409` if the scenario keeps changing concurrently while the update is retried. Requires the *Edit scenario planning* permission.
      * Update a scenario
      */
     async update(requestParameters: ScenariosApiUpdateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object> {

package/src/models/AssistantChatPollBody.ts

@@ -71,6 +71,18 @@ export interface AssistantChatPollBody {
      * @memberof AssistantChatPollBody
      */
     status: string;
+    /**
+     * While a subsession is running, how many messages it has recorded so far, which grows with each of its steps even when it calls the same tool again. Zero when no subsession is running, including once it has ended and before the turn has recorded its result.
+     * @type {number}
+     * @memberof AssistantChatPollBody
+     */
+    subsessionSteps: number;
+    /**
+     * While a subsession is running, the tool it is running now. Empty while it is thinking, and when no subsession is running. The running subsession is the run_subsession action whose toolCallId is not yet among the finished tool calls.
+     * @type {string}
+     * @memberof AssistantChatPollBody
+     */
+    subsessionTool: string;
 }
 
 /**
@@ -81,6 +93,8 @@ export function instanceOfAssistantChatPollBody(value: object): value is Assista
     if (!('finishedToolCallIds' in value) || value['finishedToolCallIds'] === undefined) return false;
     if (!('messages' in value) || value['messages'] === undefined) return false;
     if (!('status' in value) || value['status'] === undefined) return false;
+    if (!('subsessionSteps' in value) || value['subsessionSteps'] === undefined) return false;
+    if (!('subsessionTool' in value) || value['subsessionTool'] === undefined) return false;
     return true;
 }
 
@@ -99,6 +113,8 @@ export function AssistantChatPollBodyFromJSONTyped(json: any, ignoreDiscriminato
         'finishedToolCallIds': json['finishedToolCallIds'],
         'messages': ((json['messages'] as Array<any>).map(AssistantChatPollMessageFromJSON)),
         'status': json['status'],
+        'subsessionSteps': json['subsessionSteps'],
+        'subsessionTool': json['subsessionTool'],
     };
 }
 
@@ -118,6 +134,8 @@ export function AssistantChatPollBodyToJSONTyped(value?: AssistantChatPollBody |
         'finishedToolCallIds': value['finishedToolCallIds'],
         'messages': ((value['messages'] as Array<any>).map(AssistantChatPollMessageToJSON)),
         'status': value['status'],
+        'subsessionSteps': value['subsessionSteps'],
+        'subsessionTool': value['subsessionTool'],
     };
 }
 

package/src/models/AssistantChatPollMessage.ts

@@ -69,6 +69,12 @@ export interface AssistantChatPollMessage {
      * @memberof AssistantChatPollMessage
      */
     role: string;
+    /**
+     * Id of the conversation a run_subsession action message (kind 2) started, which is polled like any other conversation to follow the subsession's own steps. It is not found until the subsession has started. Empty on every other message.
+     * @type {string}
+     * @memberof AssistantChatPollMessage
+     */
+    subsessionId: string;
     /**
      * 
      * @type {string}
@@ -94,6 +100,7 @@ export function instanceOfAssistantChatPollMessage(value: object): value is Assi
     if (!('payload' in value) || value['payload'] === undefined) return false;
     if (!('requestId' in value) || value['requestId'] === undefined) return false;
     if (!('role' in value) || value['role'] === undefined) return false;
+    if (!('subsessionId' in value) || value['subsessionId'] === undefined) return false;
     if (!('text' in value) || value['text'] === undefined) return false;
     if (!('toolCallId' in value) || value['toolCallId'] === undefined) return false;
     return true;
@@ -116,6 +123,7 @@ export function AssistantChatPollMessageFromJSONTyped(json: any, ignoreDiscrimin
         'payload': json['payload'],
         'requestId': json['requestId'],
         'role': json['role'],
+        'subsessionId': json['subsessionId'],
         'text': json['text'],
         'toolCallId': json['toolCallId'],
     };
@@ -139,6 +147,7 @@ export function AssistantChatPollMessageToJSONTyped(value?: AssistantChatPollMes
         'payload': value['payload'],
         'requestId': value['requestId'],
         'role': value['role'],
+        'subsessionId': value['subsessionId'],
         'text': value['text'],
         'toolCallId': value['toolCallId'],
     };