feat(sdk): 1.0.0.160 js/python sdk

sdk/js/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-infra/sandbox",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Node.js SDK for AIO Sandbox integration providing tools and interfaces",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.mjs",

sdk/js/src/api/resources/code/client/requests/CodeExecuteRequest.ts

@@ -18,4 +18,8 @@ export interface CodeExecuteRequest {
     timeout?: number;
     /** Current working directory for code execution */
     cwd?: string;
+    /** Enable stateful execution using Jupyter kernel. When True, variables and state persist across requests with the same session_id. */
+    stateful?: boolean;
+    /** Session ID for stateful execution. Required when stateful=True to maintain state across requests. Auto-generated if not provided. */
+    session_id?: string;
 }

sdk/js/src/api/resources/jupyter/client/requests/JupyterCreateSessionRequest.ts

@@ -7,7 +7,7 @@
 export interface JupyterCreateSessionRequest {
     /** Unique identifier for the session, auto-generated if not provided */
     session_id?: string;
-    /** Kernel name to use (e.g., 'python3', 'python3.11', 'python3.12'). Defaults to 'python3' */
+    /** Kernel name: 'python3', 'python3.10', 'python3.11', 'python3.12'. Defaults to 'python3'. */
     kernel_name?: string;
     /** Current working directory for the session */
     cwd?: string;

sdk/js/src/api/resources/jupyter/client/requests/JupyterExecuteRequest.ts

@@ -11,7 +11,7 @@ export interface JupyterExecuteRequest {
     code: string;
     /** Execution timeout in seconds */
     timeout?: number;
-    /** Kernel name to use (e.g., 'python3', 'python3.11', 'python3.12'). Defaults to 'python3' */
+    /** Kernel name: 'python3', 'python3.10', 'python3.11', 'python3.12'. Defaults to 'python3'. */
     kernel_name?: string;
     /** Session ID to maintain kernel state across requests */
     session_id?: string;

sdk/js/src/api/resources/nodejs/client/createSession.ts

@@ -0,0 +1,55 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as core from "../../../../core/index.js";
+import type * as Sandbox from "../../../index.js";
+
+export type Error =
+    | Sandbox.nodejs.createSession.Error.UnprocessableEntityError
+    | Sandbox.nodejs.createSession.Error._Unknown;
+
+export namespace Error {
+    export interface UnprocessableEntityError {
+        statusCode: 422;
+        content: Sandbox.HttpValidationError;
+    }
+
+    export interface _Unknown {
+        statusCode: void;
+        content: core.Fetcher.Error;
+    }
+
+    export interface _Visitor<_Result> {
+        unprocessableEntityError: (value: Sandbox.HttpValidationError) => _Result;
+        _other: (value: core.Fetcher.Error) => _Result;
+    }
+}
+
+export const Error = {
+    unprocessableEntityError: (
+        value: Sandbox.HttpValidationError,
+    ): Sandbox.nodejs.createSession.Error.UnprocessableEntityError => {
+        return {
+            content: value,
+            statusCode: 422,
+        };
+    },
+
+    _unknown: (fetcherError: core.Fetcher.Error): Sandbox.nodejs.createSession.Error._Unknown => {
+        return {
+            statusCode: undefined,
+            content: fetcherError,
+        };
+    },
+
+    _visit: <_Result>(
+        value: Sandbox.nodejs.createSession.Error,
+        visitor: Sandbox.nodejs.createSession.Error._Visitor<_Result>,
+    ): _Result => {
+        switch (value.statusCode) {
+            case 422:
+                return visitor.unprocessableEntityError(value.content);
+            default:
+                return visitor._other(value as any);
+        }
+    },
+} as const;

sdk/js/src/api/resources/nodejs/client/deleteSession.ts

@@ -0,0 +1,55 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as core from "../../../../core/index.js";
+import type * as Sandbox from "../../../index.js";
+
+export type Error =
+    | Sandbox.nodejs.deleteSession.Error.UnprocessableEntityError
+    | Sandbox.nodejs.deleteSession.Error._Unknown;
+
+export namespace Error {
+    export interface UnprocessableEntityError {
+        statusCode: 422;
+        content: Sandbox.HttpValidationError;
+    }
+
+    export interface _Unknown {
+        statusCode: void;
+        content: core.Fetcher.Error;
+    }
+
+    export interface _Visitor<_Result> {
+        unprocessableEntityError: (value: Sandbox.HttpValidationError) => _Result;
+        _other: (value: core.Fetcher.Error) => _Result;
+    }
+}
+
+export const Error = {
+    unprocessableEntityError: (
+        value: Sandbox.HttpValidationError,
+    ): Sandbox.nodejs.deleteSession.Error.UnprocessableEntityError => {
+        return {
+            content: value,
+            statusCode: 422,
+        };
+    },
+
+    _unknown: (fetcherError: core.Fetcher.Error): Sandbox.nodejs.deleteSession.Error._Unknown => {
+        return {
+            statusCode: undefined,
+            content: fetcherError,
+        };
+    },
+
+    _visit: <_Result>(
+        value: Sandbox.nodejs.deleteSession.Error,
+        visitor: Sandbox.nodejs.deleteSession.Error._Visitor<_Result>,
+    ): _Result => {
+        switch (value.statusCode) {
+            case 422:
+                return visitor.unprocessableEntityError(value.content);
+            default:
+                return visitor._other(value as any);
+        }
+    },
+} as const;

sdk/js/src/api/resources/nodejs/client/getSession.ts

@@ -0,0 +1,53 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as core from "../../../../core/index.js";
+import type * as Sandbox from "../../../index.js";
+
+export type Error = Sandbox.nodejs.getSession.Error.UnprocessableEntityError | Sandbox.nodejs.getSession.Error._Unknown;
+
+export namespace Error {
+    export interface UnprocessableEntityError {
+        statusCode: 422;
+        content: Sandbox.HttpValidationError;
+    }
+
+    export interface _Unknown {
+        statusCode: void;
+        content: core.Fetcher.Error;
+    }
+
+    export interface _Visitor<_Result> {
+        unprocessableEntityError: (value: Sandbox.HttpValidationError) => _Result;
+        _other: (value: core.Fetcher.Error) => _Result;
+    }
+}
+
+export const Error = {
+    unprocessableEntityError: (
+        value: Sandbox.HttpValidationError,
+    ): Sandbox.nodejs.getSession.Error.UnprocessableEntityError => {
+        return {
+            content: value,
+            statusCode: 422,
+        };
+    },
+
+    _unknown: (fetcherError: core.Fetcher.Error): Sandbox.nodejs.getSession.Error._Unknown => {
+        return {
+            statusCode: undefined,
+            content: fetcherError,
+        };
+    },
+
+    _visit: <_Result>(
+        value: Sandbox.nodejs.getSession.Error,
+        visitor: Sandbox.nodejs.getSession.Error._Visitor<_Result>,
+    ): _Result => {
+        switch (value.statusCode) {
+            case 422:
+                return visitor.unprocessableEntityError(value.content);
+            default:
+                return visitor._other(value as any);
+        }
+    },
+} as const;

sdk/js/src/api/resources/nodejs/client/index.ts

@@ -1,3 +1,8 @@
+export * as createSession from "./createSession.js";
+export * as deleteSession from "./deleteSession.js";
 export * as executeCode from "./executeCode.js";
 export * as getInfo from "./getInfo.js";
+export * as getSession from "./getSession.js";
+export * as listSessions from "./listSessions.js";
 export * from "./requests/index.js";
+export * as updateSession from "./updateSession.js";

sdk/js/src/api/resources/nodejs/client/listSessions.ts

@@ -0,0 +1,36 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as core from "../../../../core/index.js";
+import type * as Sandbox from "../../../index.js";
+
+export type Error = Sandbox.nodejs.listSessions.Error._Unknown;
+
+export namespace Error {
+    export interface _Unknown {
+        statusCode: void;
+        content: core.Fetcher.Error;
+    }
+
+    export interface _Visitor<_Result> {
+        _other: (value: core.Fetcher.Error) => _Result;
+    }
+}
+
+export const Error = {
+    _unknown: (fetcherError: core.Fetcher.Error): Sandbox.nodejs.listSessions.Error._Unknown => {
+        return {
+            statusCode: undefined,
+            content: fetcherError,
+        };
+    },
+
+    _visit: <_Result>(
+        value: Sandbox.nodejs.listSessions.Error,
+        visitor: Sandbox.nodejs.listSessions.Error._Visitor<_Result>,
+    ): _Result => {
+        switch (value.statusCode) {
+            default:
+                return visitor._other(value as any);
+        }
+    },
+} as const;

sdk/js/src/api/resources/nodejs/client/requests/NodeJsCreateSessionRequest.ts

@@ -0,0 +1,14 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/**
+ * @example
+ *     {}
+ */
+export interface NodeJsCreateSessionRequest {
+    /** Custom session ID (auto-generated if not provided) */
+    session_id?: string;
+    /** Working directory for the session */
+    cwd?: string;
+    /** Maximum idle time in seconds (default 24 hours) */
+    max_idle_time?: number;
+}

sdk/js/src/api/resources/nodejs/client/requests/NodeJsExecuteRequest.ts

@@ -15,4 +15,10 @@ export interface NodeJsExecuteRequest {
     stdin?: string;
     /** Additional files to create in execution directory */
     files?: Record<string, string | undefined>;
+    /** Enable stateful execution with persistent REPL session */
+    stateful?: boolean;
+    /** Session ID for stateful execution (reuse existing session) */
+    session_id?: string;
+    /** Working directory for code execution */
+    cwd?: string;
 }

sdk/js/src/api/resources/nodejs/client/requests/NodeJsUpdateSessionRequest.ts

@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/**
+ * @example
+ *     {}
+ */
+export interface NodeJsUpdateSessionRequest {
+    /** New maximum idle time in seconds */
+    max_idle_time?: number;
+    /** New working directory */
+    cwd?: string;
+}

sdk/js/src/api/resources/nodejs/client/requests/index.ts

@@ -1 +1,3 @@
+export type { NodeJsCreateSessionRequest } from "./NodeJsCreateSessionRequest.js";
 export type { NodeJsExecuteRequest } from "./NodeJsExecuteRequest.js";
+export type { NodeJsUpdateSessionRequest } from "./NodeJsUpdateSessionRequest.js";

sdk/js/src/api/resources/nodejs/client/updateSession.ts

@@ -0,0 +1,55 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as core from "../../../../core/index.js";
+import type * as Sandbox from "../../../index.js";
+
+export type Error =
+    | Sandbox.nodejs.updateSession.Error.UnprocessableEntityError
+    | Sandbox.nodejs.updateSession.Error._Unknown;
+
+export namespace Error {
+    export interface UnprocessableEntityError {
+        statusCode: 422;
+        content: Sandbox.HttpValidationError;
+    }
+
+    export interface _Unknown {
+        statusCode: void;
+        content: core.Fetcher.Error;
+    }
+
+    export interface _Visitor<_Result> {
+        unprocessableEntityError: (value: Sandbox.HttpValidationError) => _Result;
+        _other: (value: core.Fetcher.Error) => _Result;
+    }
+}
+
+export const Error = {
+    unprocessableEntityError: (
+        value: Sandbox.HttpValidationError,
+    ): Sandbox.nodejs.updateSession.Error.UnprocessableEntityError => {
+        return {
+            content: value,
+            statusCode: 422,
+        };
+    },
+
+    _unknown: (fetcherError: core.Fetcher.Error): Sandbox.nodejs.updateSession.Error._Unknown => {
+        return {
+            statusCode: undefined,
+            content: fetcherError,
+        };
+    },
+
+    _visit: <_Result>(
+        value: Sandbox.nodejs.updateSession.Error,
+        visitor: Sandbox.nodejs.updateSession.Error._Visitor<_Result>,
+    ): _Result => {
+        switch (value.statusCode) {
+            case 422:
+                return visitor.unprocessableEntityError(value.content);
+            default:
+                return visitor._other(value as any);
+        }
+    },
+} as const;

sdk/js/src/api/types/ActionData.ts

@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/**
+ * Inner data for action response.
+ */
+export interface ActionData {
+    status: "success";
+    action_performed: string;
+}

sdk/js/src/api/types/ActionResponse.ts

@@ -1,6 +1,16 @@
 // This file was auto-generated by Fern from our API Definition.
 
+import type * as Sandbox from "../index.js";
+
+/**
+ * Response model for browser actions.
+ *
+ * Provides backward compatibility:
+ * - Old format: resp.json()['status'], resp.json()['action_performed']
+ * - New format: resp.json()['data']['status'], resp.json()['data']['action_performed']
+ */
 export interface ActionResponse {
     status: "success";
     action_performed: string;
+    data?: Sandbox.ActionData;
 }

sdk/js/src/api/types/CodeExecuteResponse.ts

@@ -22,4 +22,6 @@ export interface CodeExecuteResponse {
     exit_code?: number;
     /** Captured error traceback lines when available */
     traceback?: string[];
+    /** Session ID for stateful execution (only present when stateful=True) */
+    session_id?: string;
 }

sdk/js/src/api/types/NodeJsCreateSessionResponse.ts

@@ -0,0 +1,14 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as Sandbox from "../index.js";
+
+export interface NodeJsCreateSessionResponse {
+    /** Session ID */
+    session_id: string;
+    /** Whether the session was newly created */
+    created: boolean;
+    /** Additional message (e.g., if session already exists) */
+    message?: string;
+    /** Session information (if created) */
+    session?: Sandbox.NodeJsSessionInfo;
+}