feat: Add signal and status fields to SandboxStageResult

Co-Authored-By: Claude <noreply@anthropic.com>

Author: koki-develop

typescript/src/client.spec.ts

@@ -24,6 +24,8 @@ const sampleRunResult = {
   stderr: "",
   output: "Hello\n",
   exit_code: 0,
+  signal: null,
+  status: "SUCCESS",
 };
 
 const sampleRequest = {
@@ -120,8 +122,10 @@ describe("CodizeClient", () => {
             stderr: "",
             output: "",
             exit_code: 0,
+            signal: null,
+            status: "SUCCESS",
           },
-          run: { stdout: "ok\n", stderr: "", output: "ok\n", exit_code: 0 },
+          run: { stdout: "ok\n", stderr: "", output: "ok\n", exit_code: 0, signal: null, status: "SUCCESS" },
         };
         const fetchFn = vi.fn().mockResolvedValue(makeJsonResponse(body));
         const client = new CodizeClient({ apiKey: "key", fetchFn });
@@ -132,19 +136,23 @@ describe("CodizeClient", () => {
           stderr: "",
           output: "",
           exitCode: 0,
+          signal: null,
+          status: "SUCCESS",
         });
         expect(result.data.run).toEqual({
           stdout: "ok\n",
           stderr: "",
           output: "ok\n",
           exitCode: 0,
+          signal: null,
+          status: "SUCCESS",
         });
       });
 
       it("returns compile as null when the API returns null", async () => {
         const body = {
           compile: null,
-          run: { stdout: "", stderr: "", output: "", exit_code: 0 },
+          run: { stdout: "", stderr: "", output: "", exit_code: 0, signal: null, status: "SUCCESS" },
         };
         const fetchFn = vi.fn().mockResolvedValue(makeJsonResponse(body));
         const client = new CodizeClient({ apiKey: "key", fetchFn });

typescript/src/client.ts

@@ -75,6 +75,18 @@ export type SandboxExecuteResponse = {
   };
 };
 
+/**
+ * Execution status of a sandbox stage.
+ */
+export type SandboxStageStatus =
+  | "SUCCESS"
+  | "RUNTIME_ERROR"
+  | "SIGNAL"
+  | "TIMEOUT"
+  | "OUTPUT_LIMIT_EXCEEDED"
+  | "ERROR_LIMIT_EXCEEDED"
+  | (string & {});
+
 /**
  * Output for a single sandbox stage (compile or run).
  */
@@ -95,6 +107,14 @@ export type SandboxStageResult = {
    * Process exit code.
    */
   exitCode: number | null;
+  /**
+   * Signal name that terminated the process, or null if not terminated by a signal.
+   */
+  signal: string | null;
+  /**
+   * Execution status.
+   */
+  status: SandboxStageStatus;
 };
 
 /**
@@ -105,6 +125,8 @@ type RawStageResult = {
   stderr: string;
   output: string;
   exit_code: number | null;
+  signal: string | null;
+  status: SandboxStageStatus;
 };
 
 /**
@@ -116,6 +138,8 @@ function mapStageResult(raw: RawStageResult): SandboxStageResult {
     stderr: raw.stderr,
     output: raw.output,
     exitCode: raw.exit_code,
+    signal: raw.signal,
+    status: raw.status,
   };
 }
 

typescript/src/index.ts

@@ -7,6 +7,7 @@ export {
   type SandboxExecuteRequest,
   type SandboxExecuteResponse,
   type SandboxStageResult,
+  type SandboxStageStatus,
 } from "./client";
 
 /**