@boatdev/sdk 1.6.0 → 1.8.0

package/dist/models/StopOperation.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Boat Public API v1
+ * Public JSON API for creating, operating, prompting, observing, and exposing sandboxes from backend services, CI jobs, hosted workers, and Boat automation products.  The v1 reference intentionally documents the developer integration surface only. Dashboard billing actions are not part of v1.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface StopOperation
+ */
+export interface StopOperation {
+    /**
+     * Stable id of this stop. Calling stop again while it is pending returns the same id.
+     * @type {string}
+     * @memberof StopOperation
+     */
+    id: string;
+    /**
+     * `pending`: accepted, the sandbox is archiving. `failing`: the last attempt failed (see `error`); it is retried automatically until the sandbox archives. Running commands or prompts does not cancel it. `completed`: the sandbox is archived. `superseded`: a resume ended it before it completed.
+     * @type {StopOperationStatusEnum}
+     * @memberof StopOperation
+     */
+    status: StopOperationStatusEnum;
+    /**
+     * When the stop was accepted. On the sandbox, null once it has ended. Read by id (`GET /sandboxes/{sandboxId}/stops/{stopId}`), it is kept.
+     * @type {Date}
+     * @memberof StopOperation
+     */
+    requestedAt: Date | null;
+    /**
+     * When the last archival attempt ended.
+     * @type {Date}
+     * @memberof StopOperation
+     */
+    lastAttemptAt: Date | null;
+    /**
+     * Why the last attempt failed, while `status` is `failing`. Otherwise null.
+     * @type {string}
+     * @memberof StopOperation
+     */
+    error: string | null;
+    /**
+     * When the stop completed or was superseded.
+     * @type {Date}
+     * @memberof StopOperation
+     */
+    endedAt: Date | null;
+}
+/**
+ * @export
+ */
+export declare const StopOperationStatusEnum: {
+    readonly Pending: 'pending';
+    readonly Failing: 'failing';
+    readonly Completed: 'completed';
+    readonly Superseded: 'superseded';
+};
+export type StopOperationStatusEnum = typeof StopOperationStatusEnum[keyof typeof StopOperationStatusEnum];
+/**
+ * Check if a given object implements the StopOperation interface.
+ */
+export declare function instanceOfStopOperation(value: object): value is StopOperation;
+export declare function StopOperationFromJSON(json: any): StopOperation;
+export declare function StopOperationFromJSONTyped(json: any, ignoreDiscriminator: boolean): StopOperation;
+export declare function StopOperationToJSON(json: any): StopOperation;
+export declare function StopOperationToJSONTyped(value?: StopOperation | null, ignoreDiscriminator?: boolean): any;

package/dist/models/StopOperation.js

@@ -0,0 +1,80 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Boat Public API v1
+ * Public JSON API for creating, operating, prompting, observing, and exposing sandboxes from backend services, CI jobs, hosted workers, and Boat automation products.  The v1 reference intentionally documents the developer integration surface only. Dashboard billing actions are not part of v1.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StopOperationStatusEnum = void 0;
+exports.instanceOfStopOperation = instanceOfStopOperation;
+exports.StopOperationFromJSON = StopOperationFromJSON;
+exports.StopOperationFromJSONTyped = StopOperationFromJSONTyped;
+exports.StopOperationToJSON = StopOperationToJSON;
+exports.StopOperationToJSONTyped = StopOperationToJSONTyped;
+/**
+ * @export
+ */
+exports.StopOperationStatusEnum = {
+    Pending: 'pending',
+    Failing: 'failing',
+    Completed: 'completed',
+    Superseded: 'superseded'
+};
+/**
+ * Check if a given object implements the StopOperation interface.
+ */
+function instanceOfStopOperation(value) {
+    if (!('id' in value) || value['id'] === undefined)
+        return false;
+    if (!('status' in value) || value['status'] === undefined)
+        return false;
+    if (!('requestedAt' in value) || value['requestedAt'] === undefined)
+        return false;
+    if (!('lastAttemptAt' in value) || value['lastAttemptAt'] === undefined)
+        return false;
+    if (!('error' in value) || value['error'] === undefined)
+        return false;
+    if (!('endedAt' in value) || value['endedAt'] === undefined)
+        return false;
+    return true;
+}
+function StopOperationFromJSON(json) {
+    return StopOperationFromJSONTyped(json, false);
+}
+function StopOperationFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'id': json['id'],
+        'status': json['status'],
+        'requestedAt': (json['requestedAt'] == null ? null : new Date(json['requestedAt'])),
+        'lastAttemptAt': (json['lastAttemptAt'] == null ? null : new Date(json['lastAttemptAt'])),
+        'error': json['error'],
+        'endedAt': (json['endedAt'] == null ? null : new Date(json['endedAt'])),
+    };
+}
+function StopOperationToJSON(json) {
+    return StopOperationToJSONTyped(json, false);
+}
+function StopOperationToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'id': value['id'],
+        'status': value['status'],
+        'requestedAt': value['requestedAt'] == null ? value['requestedAt'] : value['requestedAt'].toISOString(),
+        'lastAttemptAt': value['lastAttemptAt'] == null ? value['lastAttemptAt'] : value['lastAttemptAt'].toISOString(),
+        'error': value['error'],
+        'endedAt': value['endedAt'] == null ? value['endedAt'] : value['endedAt'].toISOString(),
+    };
+}

package/dist/models/StopOperationResponse.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Boat Public API v1
+ * Public JSON API for creating, operating, prompting, observing, and exposing sandboxes from backend services, CI jobs, hosted workers, and Boat automation products.  The v1 reference intentionally documents the developer integration surface only. Dashboard billing actions are not part of v1.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { StopOperation } from './StopOperation';
+/**
+ *
+ * @export
+ * @interface StopOperationResponse
+ */
+export interface StopOperationResponse {
+    /**
+     *
+     * @type {boolean}
+     * @memberof StopOperationResponse
+     */
+    ok: boolean;
+    /**
+     *
+     * @type {StopOperationResponseTypeEnum}
+     * @memberof StopOperationResponse
+     */
+    type: StopOperationResponseTypeEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof StopOperationResponse
+     */
+    id: string;
+    /**
+     *
+     * @type {StopOperation}
+     * @memberof StopOperationResponse
+     */
+    stop: StopOperation;
+}
+/**
+ * @export
+ */
+export declare const StopOperationResponseTypeEnum: {
+    readonly StopStatus: 'stop.status';
+};
+export type StopOperationResponseTypeEnum = typeof StopOperationResponseTypeEnum[keyof typeof StopOperationResponseTypeEnum];
+/**
+ * Check if a given object implements the StopOperationResponse interface.
+ */
+export declare function instanceOfStopOperationResponse(value: object): value is StopOperationResponse;
+export declare function StopOperationResponseFromJSON(json: any): StopOperationResponse;
+export declare function StopOperationResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): StopOperationResponse;
+export declare function StopOperationResponseToJSON(json: any): StopOperationResponse;
+export declare function StopOperationResponseToJSONTyped(value?: StopOperationResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/models/StopOperationResponse.js

@@ -0,0 +1,70 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Boat Public API v1
+ * Public JSON API for creating, operating, prompting, observing, and exposing sandboxes from backend services, CI jobs, hosted workers, and Boat automation products.  The v1 reference intentionally documents the developer integration surface only. Dashboard billing actions are not part of v1.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StopOperationResponseTypeEnum = void 0;
+exports.instanceOfStopOperationResponse = instanceOfStopOperationResponse;
+exports.StopOperationResponseFromJSON = StopOperationResponseFromJSON;
+exports.StopOperationResponseFromJSONTyped = StopOperationResponseFromJSONTyped;
+exports.StopOperationResponseToJSON = StopOperationResponseToJSON;
+exports.StopOperationResponseToJSONTyped = StopOperationResponseToJSONTyped;
+const StopOperation_1 = require("./StopOperation");
+/**
+ * @export
+ */
+exports.StopOperationResponseTypeEnum = {
+    StopStatus: 'stop.status'
+};
+/**
+ * Check if a given object implements the StopOperationResponse interface.
+ */
+function instanceOfStopOperationResponse(value) {
+    if (!('ok' in value) || value['ok'] === undefined)
+        return false;
+    if (!('type' in value) || value['type'] === undefined)
+        return false;
+    if (!('id' in value) || value['id'] === undefined)
+        return false;
+    if (!('stop' in value) || value['stop'] === undefined)
+        return false;
+    return true;
+}
+function StopOperationResponseFromJSON(json) {
+    return StopOperationResponseFromJSONTyped(json, false);
+}
+function StopOperationResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'ok': json['ok'],
+        'type': json['type'],
+        'id': json['id'],
+        'stop': (0, StopOperation_1.StopOperationFromJSON)(json['stop']),
+    };
+}
+function StopOperationResponseToJSON(json) {
+    return StopOperationResponseToJSONTyped(json, false);
+}
+function StopOperationResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'ok': value['ok'],
+        'type': value['type'],
+        'id': value['id'],
+        'stop': (0, StopOperation_1.StopOperationToJSON)(value['stop']),
+    };
+}

package/dist/models/StopRequest.d.ts

@@ -16,7 +16,7 @@
  */
 export interface StopRequest {
     /**
-     * Stop the sandbox even if its disk cannot be snapshotted. Everything written since the last successful snapshot is permanently LOST. Without this, a sandbox whose snapshot pipeline is failing is left running rather than discarding your work, and you are not billed for that time. Only use this after a stop has already been refused.
+     * Stop the sandbox even if its disk cannot be snapshotted. It keeps its last successful snapshot and everything written since then is permanently LOST. Without this, a sandbox whose snapshot pipeline is failing is left running rather than discarding your work, and you are not billed for that time. Only use this after a stop has already been refused.
      * @type {boolean}
      * @memberof StopRequest
      */

package/dist/models/UpdateSandboxRequest.d.ts

@@ -22,7 +22,7 @@ export interface UpdateSandboxRequest {
      */
     name?: string;
     /**
-     * New archival TTL. `null` disables auto-stop.
+     * New auto-stop TTL. The deadline becomes now + `ttlSeconds`, so calling this again extends a running sandbox's life. `null` disables auto-stop.
      * @type {number}
      * @memberof UpdateSandboxRequest
      */

package/dist/models/index.d.ts

@@ -74,6 +74,7 @@ export * from './PromptRequest';
 export * from './PromptResponse';
 export * from './PromptRun';
 export * from './PromptRunResponse';
+export * from './Recover200Response';
 export * from './RepoSelectionRequest';
 export * from './RepoSelectionResponse';
 export * from './ReposResponse';
@@ -116,6 +117,8 @@ export * from './SteerEvent';
 export * from './SteerEventData';
 export * from './SteerRequest';
 export * from './SteerResponse';
+export * from './StopOperation';
+export * from './StopOperationResponse';
 export * from './StopRequest';
 export * from './SuccessBase';
 export * from './UnknownEvent';

package/dist/models/index.js

@@ -92,6 +92,7 @@ __exportStar(require("./PromptRequest"), exports);
 __exportStar(require("./PromptResponse"), exports);
 __exportStar(require("./PromptRun"), exports);
 __exportStar(require("./PromptRunResponse"), exports);
+__exportStar(require("./Recover200Response"), exports);
 __exportStar(require("./RepoSelectionRequest"), exports);
 __exportStar(require("./RepoSelectionResponse"), exports);
 __exportStar(require("./ReposResponse"), exports);
@@ -134,6 +135,8 @@ __exportStar(require("./SteerEvent"), exports);
 __exportStar(require("./SteerEventData"), exports);
 __exportStar(require("./SteerRequest"), exports);
 __exportStar(require("./SteerResponse"), exports);
+__exportStar(require("./StopOperation"), exports);
+__exportStar(require("./StopOperationResponse"), exports);
 __exportStar(require("./StopRequest"), exports);
 __exportStar(require("./SuccessBase"), exports);
 __exportStar(require("./UnknownEvent"), exports);

package/dist/runtime.js

@@ -1,4 +1,12 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextApiResponse = exports.BlobApiResponse = exports.VoidApiResponse = exports.JSONApiResponse = exports.COLLECTION_FORMATS = exports.RequiredError = exports.FetchError = exports.ResponseError = exports.BaseAPI = exports.DefaultConfig = exports.Configuration = exports.BASE_PATH = void 0;
+exports.querystring = querystring;
+exports.exists = exists;
+exports.mapValues = mapValues;
+exports.canConsumeForm = canConsumeForm;
+exports.unflattenBody = unflattenBody;
+const http2_fetch_1 = require("./http2-fetch");
 /* tslint:disable */
 /* eslint-disable */
 /**
@@ -12,13 +20,6 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TextApiResponse = exports.BlobApiResponse = exports.VoidApiResponse = exports.JSONApiResponse = exports.COLLECTION_FORMATS = exports.RequiredError = exports.FetchError = exports.ResponseError = exports.BaseAPI = exports.DefaultConfig = exports.Configuration = exports.BASE_PATH = void 0;
-exports.querystring = querystring;
-exports.exists = exists;
-exports.mapValues = mapValues;
-exports.canConsumeForm = canConsumeForm;
-exports.unflattenBody = unflattenBody;
 exports.BASE_PATH = "https://boat.dev/api/v1".replace(/\/+$/, "");
 class Configuration {
     constructor(configuration = {}) {
@@ -86,7 +87,7 @@ class BaseAPI {
             }
             let response = undefined;
             try {
-                response = await (this.configuration.fetchApi || fetch)(fetchParams.url, fetchParams.init);
+                response = await (this.configuration.fetchApi || http2_fetch_1.defaultFetch)(fetchParams.url, fetchParams.init);
             }
             catch (e) {
                 for (const middleware of this.middleware) {

package/docs/BoatApi.md

@@ -36,6 +36,7 @@ All URIs are relative to *https://boat.dev/api/v1*
 | [**getSnapshotDownload**](BoatApi.md#getsnapshotdownload) | **GET** /snapshots/{snapshotId}/download | Get snapshot download |
 | [**getSnapshotFile**](BoatApi.md#getsnapshotfile) | **GET** /snapshots/{snapshotId}/files | Download a file or folder from a snapshot |
 | [**getSnapshotTree**](BoatApi.md#getsnapshottree) | **GET** /snapshots/{snapshotId}/tree | Get snapshot file tree |
+| [**getStop**](BoatApi.md#getstop) | **GET** /sandboxes/{sandboxId}/stops/{stopId} | Get a stop by id |
 | [**getWebhook**](BoatApi.md#getwebhook) | **GET** /webhooks/{webhookId} | Get webhook |
 | [**hostPort**](BoatApi.md#hostportoperation) | **POST** /sandboxes/{sandboxId}/host | Expose a sandbox port on a public HTTPS URL |
 | [**interrupt**](BoatApi.md#interrupt) | **POST** /sandboxes/{sandboxId}/interrupt | Interrupt running work |
@@ -49,6 +50,7 @@ All URIs are relative to *https://boat.dev/api/v1*
 | [**prompt**](BoatApi.md#promptoperation) | **POST** /sandboxes/{sandboxId}/prompt | Prompt Sandbox |
 | [**promptRunStatus**](BoatApi.md#promptrunstatus) | **GET** /sandboxes/{sandboxId}/prompts/{promptId} | Get prompt run status |
 | [**readFile**](BoatApi.md#readfile) | **GET** /sandboxes/{sandboxId}/files | Read a file from a sandbox |
+| [**recover**](BoatApi.md#recover) | **POST** /sandboxes/{sandboxId}/recover | Recover a sandbox that stopped responding |
 | [**repos**](BoatApi.md#repos) | **GET** /repos | List GitHub repositories available to Boat |
 | [**resume**](BoatApi.md#resumeoperation) | **POST** /sandboxes/{sandboxId}/resume | Resume sandbox |
 | [**revokeApiKey**](BoatApi.md#revokeapikey) | **DELETE** /api-keys/{apiKeyId} | Revoke an API key |
@@ -297,6 +299,8 @@ This endpoint does not need any parameter.
 
 Download a sandbox artifact
 
+Downloads one file of up to 50 MiB, under /home/user or /tmp, as raw bytes.
+
 ### Example
 
 ```ts
@@ -2482,6 +2486,82 @@ example().catch(console.error);
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## getStop
+
+> StopOperationResponse getStop(sandboxId, stopId)
+
+Get a stop by id
+
+Returns one stop of this sandbox by the id that `POST /sandboxes/{sandboxId}/stop` returned. Old stops stay readable after a resume or a later stop. Returns 404 when the id is unknown or belongs to another sandbox.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BoatApi,
+} from '@boatdev/sdk';
+import type { GetStopRequest } from '@boatdev/sdk';
+
+async function example() {
+  console.log("🚀 Testing @boatdev/sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: BoatBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BoatApi(config);
+
+  const body = {
+    // string | Public Sandbox id returned by create/list/get sandbox calls.
+    sandboxId: sandboxId_example,
+    // string
+    stopId: stopId_example,
+  } satisfies GetStopRequest;
+
+  try {
+    const data = await api.getStop(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **sandboxId** | `string` | Public Sandbox id returned by create/list/get sandbox calls. | [Defaults to `undefined`] |
+| **stopId** | `string` |  | [Defaults to `undefined`] |
+
+### Return type
+
+[**StopOperationResponse**](StopOperationResponse.md)
+
+### Authorization
+
+[BoatBearerAuth](../README.md#BoatBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | The stop. |  -  |
+| **401** | Missing or invalid bearer token. |  -  |
+| **404** | Resource not found. |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## getWebhook
 
 > WebhookResponse getWebhook(webhookId)
@@ -3368,6 +3448,8 @@ example().catch(console.error);
 
 Read a file from a sandbox
 
+Files up to 5 MiB. Use `GET /sandboxes/{sandboxId}/artifacts` for files up to 50 MiB, and SCP over SSH for larger ones.
+
 ### Example
 
 ```ts
@@ -3438,6 +3520,80 @@ example().catch(console.error);
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## recover
+
+> Recover200Response recover(sandboxId)
+
+Recover a sandbox that stopped responding
+
+Power-cycle the machine of a sandbox that stopped answering. The disk is not touched. The sandbox usually answers again within 1-2 minutes and then saves your work by itself; `sandbox.recovered` fires when it does.  Refused with `409`: - `sandbox_is_reachable`: the sandbox answers normally. - `too_soon`: a recover started less than 10 minutes ago. - `no_machine`: the sandbox has no machine. Resume it instead. - `recover_unsupported`: its machine cannot be power-cycled. Wait for it to   answer, or resume it from its last snapshot. - `reset_failed`: the power-cycle failed. Reply to the incident email. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BoatApi,
+} from '@boatdev/sdk';
+import type { RecoverRequest } from '@boatdev/sdk';
+
+async function example() {
+  console.log("🚀 Testing @boatdev/sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: BoatBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BoatApi(config);
+
+  const body = {
+    // string | Public Sandbox id returned by create/list/get sandbox calls.
+    sandboxId: sandboxId_example,
+  } satisfies RecoverRequest;
+
+  try {
+    const data = await api.recover(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **sandboxId** | `string` | Public Sandbox id returned by create/list/get sandbox calls. | [Defaults to `undefined`] |
+
+### Return type
+
+[**Recover200Response**](Recover200Response.md)
+
+### Authorization
+
+[BoatBearerAuth](../README.md#BoatBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | The power-cycle started. |  -  |
+| **401** | Missing or invalid bearer token. |  -  |
+| **404** | Resource not found. |  -  |
+| **409** | The sandbox cannot be recovered now. `code` says why (see above). |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## repos
 
 > ReposResponse repos(sync, limit, cursor, sort, q, selected)
@@ -4518,7 +4674,7 @@ example().catch(console.error);
 
 Steer a running turn
 
-Send a new message to a turn that is already running, without losing what the agent is doing. This is what typing into a coding agent while it works does: the instruction is taken into account and the work continues.  Where the harness has a native mid-turn primitive (Claude Code, Codex, pi, Prime Agent) nothing is interrupted and the response has `native: true`. Where it does not (OpenCode), Boat interrupts that turn and immediately continues the SAME conversation with the instruction, keeping the session and its memory, and the response has `native: false`.  Refused with **409 `no_running_turn`** when the conversation has nothing in flight; queue work with `POST /prompt` instead. The steer shows up in `GET /events` as a `steer` event. See [Integrated agents](/integrated-agents).
+Send a new message to a turn that is already running, without losing what the agent is doing. This is what typing into a coding agent while it works does: the instruction is taken into account and the work continues.  Where the harness has a native mid-turn primitive (Claude Code, Codex, pi, Prime Agent) nothing is interrupted and the response has `native: true`. Where it does not (OpenCode), Boat interrupts that turn and immediately continues the SAME conversation with the instruction, keeping the session and its memory, and the response has `native: false`.  Refused with **409 `no_running_turn`** when the conversation has nothing in flight; queue work with `POST /prompt` instead. `error.details.reason` says why: `turn_ended` (with `error.details.lastTurn.status` and `.error` of the newest turn), `turn_not_started` (the turn is starting; retry in a moment), `no_turn`, `not_running` (the sandbox is not running) or `delivery_failed` (the sandbox did not accept the steer; check the turn before sending more work). The steer shows up in `GET /events` as a `steer` event. See [Integrated agents](/integrated-agents).
 
 ### Example
 
@@ -4600,7 +4756,7 @@ example().catch(console.error);
 
 Stop and archive sandbox
 
-Stop active work and archive/snapshot the sandbox for later resume or fork.  A stop always saves the sandbox\'s disk first. If that save is failing, the stop is refused and the sandbox keeps running so your work is not discarded, we retry automatically and email you. You are not billed for time spent in that state.  Set `force: true` to stop anyway, accepting the loss of everything written since the last successful snapshot. This is irreversible; only reach for it after a stop has already failed. 
+Stop active work and archive/snapshot the sandbox for later resume or fork.  A stop always saves the sandbox\'s disk first. If that save is failing, the stop is refused and the sandbox keeps running so your work is not discarded, we retry automatically and email you. You are not billed for time spent in that state.  The stop is an operation: the response and the sandbox carry it as `stop`, with an `id` and a `status`. Poll `GET /sandboxes/{sandboxId}` until `stop.status` is `completed`. A failed attempt shows `failing` with its `error` and is retried until the sandbox archives; commands and prompts you send meanwhile do not cancel it. Only a resume ends it early (`superseded`). Calling stop again while one is pending returns the same `id`.  Set `force: true` to stop anyway, keeping the last successful snapshot and losing everything written since then. This is irreversible; only reach for it after a stop has already failed. A force on a stop that is already pending escalates that stop. 
 
 ### Example
 
@@ -5208,6 +5364,8 @@ example().catch(console.error);
 
 Write a file in a sandbox
 
+Files up to 5 MiB after decoding. Use SCP over SSH for larger files.
+
 ### Example
 
 ```ts

package/docs/PromptRequest.md

@@ -1,7 +1,7 @@
 
 # PromptRequest
 
-Work item to queue inside an existing sandbox. Provider credentials must already be configured in the Boat dashboard.  **Providers (harnesses):** `codex`, `claude-code` (alias `claude`), `pi`, `opencode`, `prime-agent` (alias `prime`), `kimi` (Kimi Code CLI, alias `kimi-code`). Omit `provider` to use the harness the user selected on the Agents dashboard.  **Models & reasoning effort** are harness- and model-specific and change over time. Fetch the live catalog (every provider\'s models and which reasoning-effort levels each accepts) from `GET /provider-models`. Some models accept no reasoning control. `pi`, `opencode` and `prime-agent` also expose models routed through OpenRouter and llmgateway (ids like `openrouter:anthropic/claude-sonnet-4.5`).  **Conversations:** a sandbox runs many conversations in parallel, each with its own history. Set `new: true` to start a fresh conversation, or `conversationId` to continue a specific one; omit both to continue the sandbox\'s most-recently-active conversation. The response returns the `conversationId` this prompt ran in. Conversations run concurrently up to a per-sandbox limit that scales with the sandbox\'s memory; beyond it, prompts queue. 
+Work item to queue inside an existing sandbox. Provider credentials must already be configured in the Boat dashboard.  **Providers (harnesses):** `codex`, `claude-code` (alias `claude`), `pi`, `opencode`, `prime-agent` (alias `prime`), `kimi` (Kimi Code CLI, alias `kimi-code`), `mistral` (Mistral Vibe). Omit `provider` to use the harness the user selected on the Agents dashboard.  **Models & reasoning effort** are harness- and model-specific and change over time. Fetch the live catalog (every provider\'s models and which reasoning-effort levels each accepts) from `GET /provider-models`. Some models accept no reasoning control. `pi`, `opencode` and `prime-agent` also expose models routed through OpenRouter and llmgateway (ids like `openrouter:anthropic/claude-sonnet-4.5`).  **Conversations:** a sandbox runs many conversations in parallel, each with its own history. Set `new: true` to start a fresh conversation, or `conversationId` to continue a specific one; omit both to continue the sandbox\'s most-recently-active conversation. The response returns the `conversationId` this prompt ran in. Conversations run concurrently up to a per-sandbox limit that scales with the sandbox\'s memory; beyond it, prompts queue. 
 
 ## Properties
 

package/docs/Recover200Response.md

@@ -0,0 +1,38 @@
+
+# Recover200Response
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`ok` | boolean
+`type` | string
+`status` | string
+`message` | string
+
+## Example
+
+```typescript
+import type { Recover200Response } from '@boatdev/sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "ok": null,
+  "type": null,
+  "status": null,
+  "message": null,
+} satisfies Recover200Response
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as Recover200Response
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)