@leaflow/sdk 0.14.0 → 0.14.2

package/dist/compute/v1/schema.d.ts

@@ -421,6 +421,10 @@ export interface paths {
          * Run a command on an instance
          * @description Runs one command over SSH and returns what it wrote. **This is not a shell.** There is no terminal, no standard input and no way to answer a prompt: a command that waits for input produces nothing and is killed at the timeout. Chain steps with `&&`, or write a script and run that.
          *
+         *     **A command that fails is still a 200.** Its failure is its own result, not this endpoint's: read `exit_code` for what it exited with and `stderr` for what it said, and decide from those. A `grep` that matches nothing exits 1 and is a perfectly successful call.
+         *
+         *     The status therefore answers a different question — did the command run at all. A non-2xx means it did not, and nothing about the instance was changed by this request: it was suspended, not running or had no floating IP; or it refused the platform key; or the connection could not be opened. Retrying is meaningful in those cases and is not for a non-zero `exit_code`.
+         *
          *     Three conditions must hold; the instance is unreachable otherwise:
          *
          *     - it is `running`
@@ -523,6 +527,8 @@ export interface paths {
          *
          *     A soft reboot has no effect once the system is unresponsive. Set `force` to reboot forcibly: a forced reboot does not wait for the operating system to shut down, so **unwritten data is lost**.
          *
+         *     A forced reboot is accepted while the instance is already `rebooting`, which is the way out of a soft reboot the instance never carried out. Every other endpoint refuses an instance in a transient state, and a second soft reboot is refused as well.
+         *
          *     An instance suspended by the platform must be unsuspended first.
          *
          *     This endpoint returns immediately and the `status` it returns is the transient `rebooting`. Poll the instance until it settles at `running`.
@@ -1560,7 +1566,7 @@ export interface components {
         CommandResultResponseBody: {
             /**
              * Format: int64
-             * @description Null when the command was killed rather than finishing on its own, which includes the timeout
+             * @description What the command exited with, 0 being success. Any other value is the command's own verdict and still arrives as a 200. Null when it was killed rather than exiting on its own, which includes the timeout — null is the absence of a verdict, not a successful one
              */
             exit_code: number | null;
             stderr: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leaflow/sdk",
-  "version": "0.14.0",
+  "version": "0.14.2",
   "description": "Leaflow 平台 API 的 TypeScript SDK",
   "license": "MIT",
   "repository": {