@openrouter/sdk 1.2.54 → 1.2.55

package/esm/funcs/containersDownloadContainerFileContent.d.ts

@@ -0,0 +1,18 @@
+import { OpenRouterCore } from "../core.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { ConnectionError, InvalidRequestError, RequestAbortedError, RequestTimeoutError, UnexpectedClientError } from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { OpenRouterError } from "../models/errors/openroutererror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+/**
+ * Download container file content
+ *
+ * @remarks
+ * Streams the raw bytes of a file under a sandbox session prefix.
+ */
+export declare function containersDownloadContainerFileContent(client: OpenRouterCore, request: operations.DownloadContainerFileContentRequest, options?: RequestOptions): APIPromise<Result<ReadableStream<Uint8Array>, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.ForbiddenResponseError | errors.NotFoundResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.ServiceUnavailableResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+//# sourceMappingURL=containersDownloadContainerFileContent.d.ts.map

package/esm/funcs/containersDownloadContainerFileContent.js

@@ -0,0 +1,107 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 5c9b66d827d2
+ */
+import * as z from "zod/v4";
+import { encodeSimple } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import * as errors from "../models/errors/index.js";
+import * as operations from "../models/operations/index.js";
+import { APIPromise } from "../types/async.js";
+/**
+ * Download container file content
+ *
+ * @remarks
+ * Streams the raw bytes of a file under a sandbox session prefix.
+ */
+export function containersDownloadContainerFileContent(client, request, options) {
+    return new APIPromise($do(client, request, options));
+}
+async function $do(client, request, options) {
+    const parsed = safeParse(request, (value) => operations.DownloadContainerFileContentRequest$outboundSchema.parse(value), "Input validation failed");
+    if (!parsed.ok) {
+        return [parsed, { status: "invalid" }];
+    }
+    const payload = parsed.value;
+    const body = null;
+    const pathParams = {
+        file_id: encodeSimple("file_id", payload.file_id, {
+            explode: false,
+            charEncoding: "percent",
+        }),
+        session_id: encodeSimple("session_id", payload.session_id, {
+            explode: false,
+            charEncoding: "percent",
+        }),
+    };
+    const path = pathToFunc("/containers/{session_id}/files/{file_id}/content")(pathParams);
+    const headers = new Headers(compactMap({
+        Accept: "application/octet-stream",
+        "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
+    }));
+    const secConfig = await extractSecurity(client._options.apiKey);
+    const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+    const requestSecurity = resolveGlobalSecurity(securityInput);
+    const context = {
+        options: client._options,
+        baseURL: options?.serverURL ?? client._baseURL ?? "",
+        operationID: "downloadContainerFileContent",
+        oAuth2Scopes: null,
+        resolvedSecurity: requestSecurity,
+        securitySource: client._options.apiKey,
+        retryConfig: options?.retries
+            || client._options.retryConfig
+            || {
+                strategy: "backoff",
+                backoff: {
+                    initialInterval: 500,
+                    maxInterval: 60000,
+                    exponent: 1.5,
+                    maxElapsedTime: 3600000,
+                },
+                retryConnectionErrors: true,
+            }
+            || { strategy: "none" },
+        retryCodes: options?.retryCodes || ["5XX"],
+    };
+    const requestRes = client._createRequest(context, {
+        security: requestSecurity,
+        method: "GET",
+        baseURL: options?.serverURL,
+        path: path,
+        headers: headers,
+        body: body,
+        userAgent: client._options.userAgent,
+        timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+    }, options);
+    if (!requestRes.ok) {
+        return [requestRes, { status: "invalid" }];
+    }
+    const req = requestRes.value;
+    const doResult = await client._do(req, {
+        context,
+        isErrorStatusCode: (statusCode) => matchStatusCode({ status: statusCode }, ["4XX", "5XX"]),
+        retryConfig: context.retryConfig,
+        retryCodes: context.retryCodes,
+    });
+    if (!doResult.ok) {
+        return [doResult, { status: "request-error", request: req }];
+    }
+    const response = doResult.value;
+    const responseFields = {
+        HttpMeta: { Response: response, Request: req },
+    };
+    const [result] = await M.match(M.stream(200, z.custom(x => x instanceof ReadableStream)), M.jsonErr(400, errors.BadRequestResponseError$inboundSchema), M.jsonErr(401, errors.UnauthorizedResponseError$inboundSchema), M.jsonErr(403, errors.ForbiddenResponseError$inboundSchema), M.jsonErr(404, errors.NotFoundResponseError$inboundSchema), M.jsonErr(429, errors.TooManyRequestsResponseError$inboundSchema), M.jsonErr(500, errors.InternalServerResponseError$inboundSchema), M.jsonErr(503, errors.ServiceUnavailableResponseError$inboundSchema), M.fail("4XX"), M.fail("5XX"))(response, req, { extraFields: responseFields });
+    if (!result.ok) {
+        return [result, { status: "complete", request: req, response }];
+    }
+    return [result, { status: "complete", request: req, response }];
+}
+//# sourceMappingURL=containersDownloadContainerFileContent.js.map

package/esm/funcs/containersGetContainerFile.d.ts

@@ -0,0 +1,19 @@
+import { OpenRouterCore } from "../core.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { ConnectionError, InvalidRequestError, RequestAbortedError, RequestTimeoutError, UnexpectedClientError } from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { OpenRouterError } from "../models/errors/openroutererror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+/**
+ * Retrieve a container file
+ *
+ * @remarks
+ * Returns the metadata of a single file under a sandbox session prefix.
+ */
+export declare function containersGetContainerFile(client: OpenRouterCore, request: operations.GetContainerFileRequest, options?: RequestOptions): APIPromise<Result<models.ContainerFile, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.ForbiddenResponseError | errors.NotFoundResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.ServiceUnavailableResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+//# sourceMappingURL=containersGetContainerFile.d.ts.map

package/esm/funcs/containersGetContainerFile.js

@@ -0,0 +1,107 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9450910db6e6
+ */
+import { encodeSimple } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import * as errors from "../models/errors/index.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { APIPromise } from "../types/async.js";
+/**
+ * Retrieve a container file
+ *
+ * @remarks
+ * Returns the metadata of a single file under a sandbox session prefix.
+ */
+export function containersGetContainerFile(client, request, options) {
+    return new APIPromise($do(client, request, options));
+}
+async function $do(client, request, options) {
+    const parsed = safeParse(request, (value) => operations.GetContainerFileRequest$outboundSchema.parse(value), "Input validation failed");
+    if (!parsed.ok) {
+        return [parsed, { status: "invalid" }];
+    }
+    const payload = parsed.value;
+    const body = null;
+    const pathParams = {
+        file_id: encodeSimple("file_id", payload.file_id, {
+            explode: false,
+            charEncoding: "percent",
+        }),
+        session_id: encodeSimple("session_id", payload.session_id, {
+            explode: false,
+            charEncoding: "percent",
+        }),
+    };
+    const path = pathToFunc("/containers/{session_id}/files/{file_id}")(pathParams);
+    const headers = new Headers(compactMap({
+        Accept: "application/json",
+        "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
+    }));
+    const secConfig = await extractSecurity(client._options.apiKey);
+    const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+    const requestSecurity = resolveGlobalSecurity(securityInput);
+    const context = {
+        options: client._options,
+        baseURL: options?.serverURL ?? client._baseURL ?? "",
+        operationID: "getContainerFile",
+        oAuth2Scopes: null,
+        resolvedSecurity: requestSecurity,
+        securitySource: client._options.apiKey,
+        retryConfig: options?.retries
+            || client._options.retryConfig
+            || {
+                strategy: "backoff",
+                backoff: {
+                    initialInterval: 500,
+                    maxInterval: 60000,
+                    exponent: 1.5,
+                    maxElapsedTime: 3600000,
+                },
+                retryConnectionErrors: true,
+            }
+            || { strategy: "none" },
+        retryCodes: options?.retryCodes || ["5XX"],
+    };
+    const requestRes = client._createRequest(context, {
+        security: requestSecurity,
+        method: "GET",
+        baseURL: options?.serverURL,
+        path: path,
+        headers: headers,
+        body: body,
+        userAgent: client._options.userAgent,
+        timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+    }, options);
+    if (!requestRes.ok) {
+        return [requestRes, { status: "invalid" }];
+    }
+    const req = requestRes.value;
+    const doResult = await client._do(req, {
+        context,
+        isErrorStatusCode: (statusCode) => matchStatusCode({ status: statusCode }, ["4XX", "5XX"]),
+        retryConfig: context.retryConfig,
+        retryCodes: context.retryCodes,
+    });
+    if (!doResult.ok) {
+        return [doResult, { status: "request-error", request: req }];
+    }
+    const response = doResult.value;
+    const responseFields = {
+        HttpMeta: { Response: response, Request: req },
+    };
+    const [result] = await M.match(M.json(200, models.ContainerFile$inboundSchema), M.jsonErr(400, errors.BadRequestResponseError$inboundSchema), M.jsonErr(401, errors.UnauthorizedResponseError$inboundSchema), M.jsonErr(403, errors.ForbiddenResponseError$inboundSchema), M.jsonErr(404, errors.NotFoundResponseError$inboundSchema), M.jsonErr(429, errors.TooManyRequestsResponseError$inboundSchema), M.jsonErr(500, errors.InternalServerResponseError$inboundSchema), M.jsonErr(503, errors.ServiceUnavailableResponseError$inboundSchema), M.fail("4XX"), M.fail("5XX"))(response, req, { extraFields: responseFields });
+    if (!result.ok) {
+        return [result, { status: "complete", request: req, response }];
+    }
+    return [result, { status: "complete", request: req, response }];
+}
+//# sourceMappingURL=containersGetContainerFile.js.map

package/esm/funcs/containersListContainerFiles.d.ts

@@ -0,0 +1,19 @@
+import { OpenRouterCore } from "../core.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { ConnectionError, InvalidRequestError, RequestAbortedError, RequestTimeoutError, UnexpectedClientError } from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { OpenRouterError } from "../models/errors/openroutererror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+/**
+ * List container files
+ *
+ * @remarks
+ * Lists the files under a sandbox session prefix, in lexicographic path order. A restarted session is a separate container with its own session id. Paginate with `limit` and `after` (pass the previous page’s `last_id`); `has_more: true` always means the next page is fetchable that way.
+ */
+export declare function containersListContainerFiles(client: OpenRouterCore, request: operations.ListContainerFilesRequest, options?: RequestOptions): APIPromise<Result<models.ContainerFileListResponse, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.ForbiddenResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.ServiceUnavailableResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+//# sourceMappingURL=containersListContainerFiles.d.ts.map

package/esm/funcs/containersListContainerFiles.js

@@ -0,0 +1,108 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a5b09a82f065
+ */
+import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import * as errors from "../models/errors/index.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { APIPromise } from "../types/async.js";
+/**
+ * List container files
+ *
+ * @remarks
+ * Lists the files under a sandbox session prefix, in lexicographic path order. A restarted session is a separate container with its own session id. Paginate with `limit` and `after` (pass the previous page’s `last_id`); `has_more: true` always means the next page is fetchable that way.
+ */
+export function containersListContainerFiles(client, request, options) {
+    return new APIPromise($do(client, request, options));
+}
+async function $do(client, request, options) {
+    const parsed = safeParse(request, (value) => operations.ListContainerFilesRequest$outboundSchema.parse(value), "Input validation failed");
+    if (!parsed.ok) {
+        return [parsed, { status: "invalid" }];
+    }
+    const payload = parsed.value;
+    const body = null;
+    const pathParams = {
+        session_id: encodeSimple("session_id", payload.session_id, {
+            explode: false,
+            charEncoding: "percent",
+        }),
+    };
+    const path = pathToFunc("/containers/{session_id}/files")(pathParams);
+    const query = encodeFormQuery({
+        "after": payload.after,
+        "limit": payload.limit,
+    });
+    const headers = new Headers(compactMap({
+        Accept: "application/json",
+        "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
+    }));
+    const secConfig = await extractSecurity(client._options.apiKey);
+    const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+    const requestSecurity = resolveGlobalSecurity(securityInput);
+    const context = {
+        options: client._options,
+        baseURL: options?.serverURL ?? client._baseURL ?? "",
+        operationID: "listContainerFiles",
+        oAuth2Scopes: null,
+        resolvedSecurity: requestSecurity,
+        securitySource: client._options.apiKey,
+        retryConfig: options?.retries
+            || client._options.retryConfig
+            || {
+                strategy: "backoff",
+                backoff: {
+                    initialInterval: 500,
+                    maxInterval: 60000,
+                    exponent: 1.5,
+                    maxElapsedTime: 3600000,
+                },
+                retryConnectionErrors: true,
+            }
+            || { strategy: "none" },
+        retryCodes: options?.retryCodes || ["5XX"],
+    };
+    const requestRes = client._createRequest(context, {
+        security: requestSecurity,
+        method: "GET",
+        baseURL: options?.serverURL,
+        path: path,
+        headers: headers,
+        query: query,
+        body: body,
+        userAgent: client._options.userAgent,
+        timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+    }, options);
+    if (!requestRes.ok) {
+        return [requestRes, { status: "invalid" }];
+    }
+    const req = requestRes.value;
+    const doResult = await client._do(req, {
+        context,
+        isErrorStatusCode: (statusCode) => matchStatusCode({ status: statusCode }, ["4XX", "5XX"]),
+        retryConfig: context.retryConfig,
+        retryCodes: context.retryCodes,
+    });
+    if (!doResult.ok) {
+        return [doResult, { status: "request-error", request: req }];
+    }
+    const response = doResult.value;
+    const responseFields = {
+        HttpMeta: { Response: response, Request: req },
+    };
+    const [result] = await M.match(M.json(200, models.ContainerFileListResponse$inboundSchema), M.jsonErr(400, errors.BadRequestResponseError$inboundSchema), M.jsonErr(401, errors.UnauthorizedResponseError$inboundSchema), M.jsonErr(403, errors.ForbiddenResponseError$inboundSchema), M.jsonErr(429, errors.TooManyRequestsResponseError$inboundSchema), M.jsonErr(500, errors.InternalServerResponseError$inboundSchema), M.jsonErr(503, errors.ServiceUnavailableResponseError$inboundSchema), M.fail("4XX"), M.fail("5XX"))(response, req, { extraFields: responseFields });
+    if (!result.ok) {
+        return [result, { status: "complete", request: req, response }];
+    }
+    return [result, { status: "complete", request: req, response }];
+}
+//# sourceMappingURL=containersListContainerFiles.js.map

package/esm/lib/config.d.ts

@@ -50,8 +50,8 @@ export declare function serverURLFromOptions(options: SDKOptions): URL | null;
 export declare const SDK_METADATA: {
     readonly language: "typescript";
     readonly openapiDocVersion: "1.0.0";
-    readonly sdkVersion: "1.2.54";
+    readonly sdkVersion: "1.2.55";
     readonly genVersion: "2.914.0";
-    readonly userAgent: "speakeasy-sdk/typescript 1.2.54 2.914.0 1.0.0 @openrouter/sdk";
+    readonly userAgent: "speakeasy-sdk/typescript 1.2.55 2.914.0 1.0.0 @openrouter/sdk";
 };
 //# sourceMappingURL=config.d.ts.map

package/esm/lib/config.js

@@ -29,8 +29,8 @@ export function serverURLFromOptions(options) {
 export const SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.0.0",
-    sdkVersion: "1.2.54",
+    sdkVersion: "1.2.55",
     genVersion: "2.914.0",
-    userAgent: "speakeasy-sdk/typescript 1.2.54 2.914.0 1.0.0 @openrouter/sdk",
+    userAgent: "speakeasy-sdk/typescript 1.2.55 2.914.0 1.0.0 @openrouter/sdk",
 };
 //# sourceMappingURL=config.js.map

package/esm/models/containerfile.d.ts

@@ -0,0 +1,53 @@
+import * as z from "zod/v4";
+import { ClosedEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+export declare const ContainerFileObject: {
+    readonly ContainerFile: "container.file";
+};
+export type ContainerFileObject = ClosedEnum<typeof ContainerFileObject>;
+/**
+ * Container files are always produced by the assistant sandbox.
+ */
+export declare const ContainerFileSource: {
+    readonly Assistant: "assistant";
+};
+/**
+ * Container files are always produced by the assistant sandbox.
+ */
+export type ContainerFileSource = ClosedEnum<typeof ContainerFileSource>;
+export type ContainerFile = {
+    /**
+     * File size in bytes.
+     */
+    bytes: number;
+    /**
+     * The container the file belongs to — echoes the `session_id` path parameter (OpenAI field name).
+     */
+    containerId: string;
+    /**
+     * Unix timestamp (seconds) when the file was last synced.
+     */
+    createdAt: number;
+    /**
+     * Container file id: `cfile_` + base64url of the file path.
+     */
+    id: string;
+    object: ContainerFileObject;
+    /**
+     * Session-relative file path inside the container.
+     */
+    path: string;
+    /**
+     * Container files are always produced by the assistant sandbox.
+     */
+    source: ContainerFileSource;
+};
+/** @internal */
+export declare const ContainerFileObject$inboundSchema: z.ZodEnum<typeof ContainerFileObject>;
+/** @internal */
+export declare const ContainerFileSource$inboundSchema: z.ZodEnum<typeof ContainerFileSource>;
+/** @internal */
+export declare const ContainerFile$inboundSchema: z.ZodType<ContainerFile, unknown>;
+export declare function containerFileFromJSON(jsonString: string): SafeParseResult<ContainerFile, SDKValidationError>;
+//# sourceMappingURL=containerfile.d.ts.map

package/esm/models/containerfile.js

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ece4a8ddc017
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+export const ContainerFileObject = {
+    ContainerFile: "container.file",
+};
+/**
+ * Container files are always produced by the assistant sandbox.
+ */
+export const ContainerFileSource = {
+    Assistant: "assistant",
+};
+/** @internal */
+export const ContainerFileObject$inboundSchema = z.enum(ContainerFileObject);
+/** @internal */
+export const ContainerFileSource$inboundSchema = z.enum(ContainerFileSource);
+/** @internal */
+export const ContainerFile$inboundSchema = z
+    .object({
+    bytes: z.int(),
+    container_id: z.string(),
+    created_at: z.int(),
+    id: z.string(),
+    object: ContainerFileObject$inboundSchema,
+    path: z.string(),
+    source: ContainerFileSource$inboundSchema,
+}).transform((v) => {
+    return remap$(v, {
+        "container_id": "containerId",
+        "created_at": "createdAt",
+    });
+});
+export function containerFileFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => ContainerFile$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ContainerFile' from JSON`);
+}
+//# sourceMappingURL=containerfile.js.map

package/esm/models/containerfilelistresponse.d.ts

@@ -0,0 +1,25 @@
+import * as z from "zod/v4";
+import { ClosedEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { ContainerFile } from "./containerfile.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+export declare const ContainerFileListResponseObject: {
+    readonly List: "list";
+};
+export type ContainerFileListResponseObject = ClosedEnum<typeof ContainerFileListResponseObject>;
+export type ContainerFileListResponse = {
+    data: Array<ContainerFile>;
+    firstId: string | null;
+    /**
+     * True when another page can be fetched by passing `after=last_id`.
+     */
+    hasMore: boolean;
+    lastId: string | null;
+    object: ContainerFileListResponseObject;
+};
+/** @internal */
+export declare const ContainerFileListResponseObject$inboundSchema: z.ZodEnum<typeof ContainerFileListResponseObject>;
+/** @internal */
+export declare const ContainerFileListResponse$inboundSchema: z.ZodType<ContainerFileListResponse, unknown>;
+export declare function containerFileListResponseFromJSON(jsonString: string): SafeParseResult<ContainerFileListResponse, SDKValidationError>;
+//# sourceMappingURL=containerfilelistresponse.d.ts.map

package/esm/models/containerfilelistresponse.js

@@ -0,0 +1,31 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 74b945b6c8e1
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { ContainerFile$inboundSchema } from "./containerfile.js";
+export const ContainerFileListResponseObject = {
+    List: "list",
+};
+/** @internal */
+export const ContainerFileListResponseObject$inboundSchema = z.enum(ContainerFileListResponseObject);
+/** @internal */
+export const ContainerFileListResponse$inboundSchema = z.object({
+    data: z.array(ContainerFile$inboundSchema),
+    first_id: z.nullable(z.string()),
+    has_more: z.boolean(),
+    last_id: z.nullable(z.string()),
+    object: ContainerFileListResponseObject$inboundSchema,
+}).transform((v) => {
+    return remap$(v, {
+        "first_id": "firstId",
+        "has_more": "hasMore",
+        "last_id": "lastId",
+    });
+});
+export function containerFileListResponseFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => ContainerFileListResponse$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ContainerFileListResponse' from JSON`);
+}
+//# sourceMappingURL=containerfilelistresponse.js.map

package/esm/models/index.d.ts

@@ -148,6 +148,8 @@ export * from "./compoundfilter.js";
 export * from "./computeruseservertool.js";
 export * from "./conflictresponseerrordata.js";
 export * from "./containerautoenvironment.js";
+export * from "./containerfile.js";
+export * from "./containerfilelistresponse.js";
 export * from "./containerreferenceenvironment.js";
 export * from "./contentfilteraction.js";
 export * from "./contentfilterbuiltinaction.js";

package/esm/models/index.js

@@ -152,6 +152,8 @@ export * from "./compoundfilter.js";
 export * from "./computeruseservertool.js";
 export * from "./conflictresponseerrordata.js";
 export * from "./containerautoenvironment.js";
+export * from "./containerfile.js";
+export * from "./containerfilelistresponse.js";
 export * from "./containerreferenceenvironment.js";
 export * from "./contentfilteraction.js";
 export * from "./contentfilterbuiltinaction.js";

package/esm/models/operations/downloadcontainerfilecontent.d.ts

@@ -0,0 +1,63 @@
+import * as z from "zod/v4";
+export type DownloadContainerFileContentGlobals = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+};
+export type DownloadContainerFileContentRequest = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+    /**
+     * The sandbox session id, exactly as stored — a restarted session has its own `-r<nonce>`-suffixed id.
+     */
+    sessionId: string;
+    /**
+     * Container file id (`cfile_` + base64url of the file path).
+     */
+    fileId: string;
+};
+/** @internal */
+export type DownloadContainerFileContentRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    session_id: string;
+    file_id: string;
+};
+/** @internal */
+export declare const DownloadContainerFileContentRequest$outboundSchema: z.ZodType<DownloadContainerFileContentRequest$Outbound, DownloadContainerFileContentRequest>;
+export declare function downloadContainerFileContentRequestToJSON(downloadContainerFileContentRequest: DownloadContainerFileContentRequest): string;
+//# sourceMappingURL=downloadcontainerfilecontent.d.ts.map

package/esm/models/operations/downloadcontainerfilecontent.js

@@ -0,0 +1,24 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 0bc1bd778769
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+/** @internal */
+export const DownloadContainerFileContentRequest$outboundSchema = z.object({
+    httpReferer: z.string().optional(),
+    appTitle: z.string().optional(),
+    appCategories: z.string().optional(),
+    sessionId: z.string(),
+    fileId: z.string(),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+        sessionId: "session_id",
+        fileId: "file_id",
+    });
+});
+export function downloadContainerFileContentRequestToJSON(downloadContainerFileContentRequest) {
+    return JSON.stringify(DownloadContainerFileContentRequest$outboundSchema.parse(downloadContainerFileContentRequest));
+}
+//# sourceMappingURL=downloadcontainerfilecontent.js.map

package/esm/models/operations/getcontainerfile.d.ts

@@ -0,0 +1,63 @@
+import * as z from "zod/v4";
+export type GetContainerFileGlobals = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+};
+export type GetContainerFileRequest = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+    /**
+     * The sandbox session id, exactly as stored — a restarted session has its own `-r<nonce>`-suffixed id.
+     */
+    sessionId: string;
+    /**
+     * Container file id (`cfile_` + base64url of the file path).
+     */
+    fileId: string;
+};
+/** @internal */
+export type GetContainerFileRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    session_id: string;
+    file_id: string;
+};
+/** @internal */
+export declare const GetContainerFileRequest$outboundSchema: z.ZodType<GetContainerFileRequest$Outbound, GetContainerFileRequest>;
+export declare function getContainerFileRequestToJSON(getContainerFileRequest: GetContainerFileRequest): string;
+//# sourceMappingURL=getcontainerfile.d.ts.map

package/esm/models/operations/getcontainerfile.js

@@ -0,0 +1,24 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2fb4120bb6ff
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+/** @internal */
+export const GetContainerFileRequest$outboundSchema = z.object({
+    httpReferer: z.string().optional(),
+    appTitle: z.string().optional(),
+    appCategories: z.string().optional(),
+    sessionId: z.string(),
+    fileId: z.string(),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+        sessionId: "session_id",
+        fileId: "file_id",
+    });
+});
+export function getContainerFileRequestToJSON(getContainerFileRequest) {
+    return JSON.stringify(GetContainerFileRequest$outboundSchema.parse(getContainerFileRequest));
+}
+//# sourceMappingURL=getcontainerfile.js.map

package/esm/models/operations/index.d.ts

@@ -30,12 +30,14 @@ export * from "./deleteobservabilitydestination.js";
 export * from "./deletescimgroupmapping.js";
 export * from "./deleteworkspace.js";
 export * from "./deleteworkspacebudget.js";
+export * from "./downloadcontainerfilecontent.js";
 export * from "./downloadfilecontent.js";
 export * from "./exchangeauthcodeforapikey.js";
 export * from "./getanalyticsmeta.js";
 export * from "./getapprankings.js";
 export * from "./getbenchmarks.js";
 export * from "./getbyokkey.js";
+export * from "./getcontainerfile.js";
 export * from "./getcredits.js";
 export * from "./getcurrentkey.js";
 export * from "./getfilemetadata.js";
@@ -57,6 +59,7 @@ export * from "./getworkspace.js";
 export * from "./getworkspacebudget.js";
 export * from "./list.js";
 export * from "./listbyokkeys.js";
+export * from "./listcontainerfiles.js";
 export * from "./listembeddingsmodels.js";
 export * from "./listendpoints.js";
 export * from "./listendpointszdr.js";

package/esm/models/operations/index.js

@@ -34,12 +34,14 @@ export * from "./deleteobservabilitydestination.js";
 export * from "./deletescimgroupmapping.js";
 export * from "./deleteworkspace.js";
 export * from "./deleteworkspacebudget.js";
+export * from "./downloadcontainerfilecontent.js";
 export * from "./downloadfilecontent.js";
 export * from "./exchangeauthcodeforapikey.js";
 export * from "./getanalyticsmeta.js";
 export * from "./getapprankings.js";
 export * from "./getbenchmarks.js";
 export * from "./getbyokkey.js";
+export * from "./getcontainerfile.js";
 export * from "./getcredits.js";
 export * from "./getcurrentkey.js";
 export * from "./getfilemetadata.js";
@@ -61,6 +63,7 @@ export * from "./getworkspace.js";
 export * from "./getworkspacebudget.js";
 export * from "./list.js";
 export * from "./listbyokkeys.js";
+export * from "./listcontainerfiles.js";
 export * from "./listembeddingsmodels.js";
 export * from "./listendpoints.js";
 export * from "./listendpointszdr.js";

package/esm/models/operations/listcontainerfiles.d.ts

@@ -0,0 +1,68 @@
+import * as z from "zod/v4";
+export type ListContainerFilesGlobals = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+};
+export type ListContainerFilesRequest = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+    /**
+     * The sandbox session id, exactly as stored — a restarted session has its own `-r<nonce>`-suffixed id.
+     */
+    sessionId: string;
+    /**
+     * Maximum number of files to return (1-1000). Defaults to 100 when absent.
+     */
+    limit?: number | undefined;
+    /**
+     * Forward cursor: a container file id from a previous page (typically `last_id`); listing resumes strictly after that file.
+     */
+    after?: string | undefined;
+};
+/** @internal */
+export type ListContainerFilesRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    session_id: string;
+    limit: number;
+    after?: string | undefined;
+};
+/** @internal */
+export declare const ListContainerFilesRequest$outboundSchema: z.ZodType<ListContainerFilesRequest$Outbound, ListContainerFilesRequest>;
+export declare function listContainerFilesRequestToJSON(listContainerFilesRequest: ListContainerFilesRequest): string;
+//# sourceMappingURL=listcontainerfiles.d.ts.map

package/esm/models/operations/listcontainerfiles.js

@@ -0,0 +1,24 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 833ac1772f55
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+/** @internal */
+export const ListContainerFilesRequest$outboundSchema = z.object({
+    httpReferer: z.string().optional(),
+    appTitle: z.string().optional(),
+    appCategories: z.string().optional(),
+    sessionId: z.string(),
+    limit: z.int().default(100),
+    after: z.string().optional(),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+        sessionId: "session_id",
+    });
+});
+export function listContainerFilesRequestToJSON(listContainerFilesRequest) {
+    return JSON.stringify(ListContainerFilesRequest$outboundSchema.parse(listContainerFilesRequest));
+}
+//# sourceMappingURL=listcontainerfiles.js.map

package/esm/sdk/containers.d.ts

@@ -0,0 +1,27 @@
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+export declare class Containers extends ClientSDK {
+    /**
+     * List container files
+     *
+     * @remarks
+     * Lists the files under a sandbox session prefix, in lexicographic path order. A restarted session is a separate container with its own session id. Paginate with `limit` and `after` (pass the previous page’s `last_id`); `has_more: true` always means the next page is fetchable that way.
+     */
+    listContainerFiles(request: operations.ListContainerFilesRequest, options?: RequestOptions): Promise<models.ContainerFileListResponse>;
+    /**
+     * Retrieve a container file
+     *
+     * @remarks
+     * Returns the metadata of a single file under a sandbox session prefix.
+     */
+    getContainerFile(request: operations.GetContainerFileRequest, options?: RequestOptions): Promise<models.ContainerFile>;
+    /**
+     * Download container file content
+     *
+     * @remarks
+     * Streams the raw bytes of a file under a sandbox session prefix.
+     */
+    downloadContainerFileContent(request: operations.DownloadContainerFileContentRequest, options?: RequestOptions): Promise<ReadableStream<Uint8Array>>;
+}
+//# sourceMappingURL=containers.d.ts.map

package/esm/sdk/containers.js

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f772470024e6
+ */
+import { containersDownloadContainerFileContent } from "../funcs/containersDownloadContainerFileContent.js";
+import { containersGetContainerFile } from "../funcs/containersGetContainerFile.js";
+import { containersListContainerFiles } from "../funcs/containersListContainerFiles.js";
+import { ClientSDK } from "../lib/sdks.js";
+import { unwrapAsync } from "../types/fp.js";
+export class Containers extends ClientSDK {
+    /**
+     * List container files
+     *
+     * @remarks
+     * Lists the files under a sandbox session prefix, in lexicographic path order. A restarted session is a separate container with its own session id. Paginate with `limit` and `after` (pass the previous page’s `last_id`); `has_more: true` always means the next page is fetchable that way.
+     */
+    async listContainerFiles(request, options) {
+        return unwrapAsync(containersListContainerFiles(this, request, options));
+    }
+    /**
+     * Retrieve a container file
+     *
+     * @remarks
+     * Returns the metadata of a single file under a sandbox session prefix.
+     */
+    async getContainerFile(request, options) {
+        return unwrapAsync(containersGetContainerFile(this, request, options));
+    }
+    /**
+     * Download container file content
+     *
+     * @remarks
+     * Streams the raw bytes of a file under a sandbox session prefix.
+     */
+    async downloadContainerFileContent(request, options) {
+        return unwrapAsync(containersDownloadContainerFileContent(this, request, options));
+    }
+}
+//# sourceMappingURL=containers.js.map

package/esm/sdk/sdk.d.ts

@@ -6,6 +6,7 @@ import { Beta } from "./beta.js";
 import { BYOK } from "./byok.js";
 import { Chat } from "./chat.js";
 import { Classifications } from "./classifications.js";
+import { Containers } from "./containers.js";
 import { Credits } from "./credits.js";
 import { Datasets } from "./datasets.js";
 import { Embeddings } from "./embeddings.js";
@@ -50,6 +51,8 @@ export declare class OpenRouter extends ClientSDK {
     get chat(): Chat;
     private _classifications?;
     get classifications(): Classifications;
+    private _containers?;
+    get containers(): Containers;
     private _credits?;
     get credits(): Credits;
     private _datasets?;

package/esm/sdk/sdk.js

@@ -10,6 +10,7 @@ import { Beta } from "./beta.js";
 import { BYOK } from "./byok.js";
 import { Chat } from "./chat.js";
 import { Classifications } from "./classifications.js";
+import { Containers } from "./containers.js";
 import { Credits } from "./credits.js";
 import { Datasets } from "./datasets.js";
 import { Embeddings } from "./embeddings.js";
@@ -60,6 +61,9 @@ export class OpenRouter extends ClientSDK {
     get classifications() {
         return (this._classifications ?? (this._classifications = new Classifications(this._options)));
     }
+    get containers() {
+        return (this._containers ?? (this._containers = new Containers(this._options)));
+    }
     get credits() {
         return (this._credits ?? (this._credits = new Credits(this._options)));
     }

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@openrouter/sdk",
-  "version": "1.2.54",
+  "version": "1.2.55",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "1.2.54",
+  "version": "1.2.55",
   "author": "OpenRouter",
   "description": "The OpenRouter TypeScript SDK is a type-safe toolkit for building AI applications with access to 400+ language models through a unified API.",
   "keywords": [
@@ -74,14 +74,14 @@
     "build": "tsc",
     "prepublishOnly": "npm run build",
     "postinstall": "node scripts/check-types.js || true",
+    "prepare": "npm run build",
     "test": "vitest --run --project unit",
-    "test:e2e": "vitest --run --project e2e",
     "test:transit": "exit 0",
     "test:watch": "vitest --watch --project unit",
+    "typecheck": "tsc --noEmit",
     "typecheck:transit": "exit 0",
     "compile": "tsc",
-    "prepare": "npm run build",
-    "typecheck": "tsc --noEmit"
+    "test:e2e": "vitest --run --project e2e"
   },
   "peerDependencies": {},
   "devDependencies": {