@openrouter/sdk 1.2.63 → 1.2.65

package/esm/funcs/containersPromoteContainerFile.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";
+/**
+ * Promote a container file into workspace documents
+ *
+ * @remarks
+ * Copies a file from the container's sandbox prefix into the workspace's durable document storage, so it outlives the container. Returns the new document in the Files API shape, with a durable file id in the documents namespace. The copy counts against the workspace's storage quota exactly like an upload.
+ */
+export declare function containersPromoteContainerFile(client: OpenRouterCore, request: operations.PromoteContainerFileRequest, options?: RequestOptions): APIPromise<Result<models.FileResponse, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.ForbiddenResponseError | errors.NotFoundResponseError | errors.PayloadTooLargeResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.ServiceUnavailableResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+//# sourceMappingURL=containersPromoteContainerFile.d.ts.map

package/esm/funcs/containersPromoteContainerFile.js

@@ -0,0 +1,107 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b1e9dfab640d
+ */
+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";
+/**
+ * Promote a container file into workspace documents
+ *
+ * @remarks
+ * Copies a file from the container's sandbox prefix into the workspace's durable document storage, so it outlives the container. Returns the new document in the Files API shape, with a durable file id in the documents namespace. The copy counts against the workspace's storage quota exactly like an upload.
+ */
+export function containersPromoteContainerFile(client, request, options) {
+    return new APIPromise($do(client, request, options));
+}
+async function $do(client, request, options) {
+    const parsed = safeParse(request, (value) => operations.PromoteContainerFileRequest$outboundSchema.parse(value), "Input validation failed");
+    if (!parsed.ok) {
+        return [parsed, { status: "invalid" }];
+    }
+    const payload = parsed.value;
+    const body = null;
+    const pathParams = {
+        container_id: encodeSimple("container_id", payload.container_id, {
+            explode: false,
+            charEncoding: "percent",
+        }),
+        file_id: encodeSimple("file_id", payload.file_id, {
+            explode: false,
+            charEncoding: "percent",
+        }),
+    };
+    const path = pathToFunc("/containers/{container_id}/files/{file_id}/promote")(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: "promoteContainerFile",
+        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: "POST",
+        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.FileResponse$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(413, errors.PayloadTooLargeResponseError$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=containersPromoteContainerFile.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.63";
+    readonly sdkVersion: "1.2.65";
     readonly genVersion: "2.914.0";
-    readonly userAgent: "speakeasy-sdk/typescript 1.2.63 2.914.0 1.0.0 @openrouter/sdk";
+    readonly userAgent: "speakeasy-sdk/typescript 1.2.65 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.63",
+    sdkVersion: "1.2.65",
     genVersion: "2.914.0",
-    userAgent: "speakeasy-sdk/typescript 1.2.63 2.914.0 1.0.0 @openrouter/sdk",
+    userAgent: "speakeasy-sdk/typescript 1.2.65 2.914.0 1.0.0 @openrouter/sdk",
 };
 //# sourceMappingURL=config.js.map

package/esm/models/containerautoenvironment.d.ts

@@ -4,6 +4,10 @@ import { ContainerNetworkPolicy, ContainerNetworkPolicy$Outbound } from "./conta
  * An OpenRouter-managed, auto-provisioned ephemeral container.
  */
 export type ContainerAutoEnvironment = {
+    /**
+     * Workspace file ids (or_file_…) to attach into the container before the first command runs. Each file is copied to the container home as a writable copy named {last 8 characters of the file id}-{base filename} (a file stored as data/report.csv with id or_file_…NR6q4V8w attaches to ~/NR6q4V8w-report.csv), so same-named files never collide; the source document is never modified. Unknown, foreign, or malformed ids fail the request with a 400 before any command executes. Max 20 ids.
+     */
+    fileIds?: Array<string> | undefined;
     /**
      * Network egress policy for the container. "disabled" blocks all outbound internet; "allowlist" permits only hosts matching the listed hostnames or * glob patterns (ports 80/443, DNS via Cloudflare resolvers). The policy is fixed when a container starts: sending a different policy to a warm container fails the request with a 409. Omitted: defaults to "disabled" (no outbound internet). For unrestricted egress, use an allowlist of ["*"].
      */
@@ -12,6 +16,7 @@ export type ContainerAutoEnvironment = {
 };
 /** @internal */
 export type ContainerAutoEnvironment$Outbound = {
+    file_ids?: Array<string> | undefined;
     network_policy?: ContainerNetworkPolicy$Outbound | undefined;
     type: "container_auto";
 };

package/esm/models/containerautoenvironment.js

@@ -7,10 +7,12 @@ import { remap as remap$ } from "../lib/primitives.js";
 import { ContainerNetworkPolicy$outboundSchema, } from "./containernetworkpolicy.js";
 /** @internal */
 export const ContainerAutoEnvironment$outboundSchema = z.object({
+    fileIds: z.array(z.string()).optional(),
     networkPolicy: ContainerNetworkPolicy$outboundSchema.optional(),
     type: z.literal("container_auto"),
 }).transform((v) => {
     return remap$(v, {
+        fileIds: "file_ids",
         networkPolicy: "network_policy",
     });
 });

package/esm/models/containerreferenceenvironment.d.ts

@@ -8,6 +8,10 @@ export type ContainerReferenceEnvironment = {
      * Canonical container id to reuse (max 40 characters, letters/digits/underscores/hyphens). Any container_id previously returned by a bash or shell tool result works here and reattaches to the same container and files — including session-derived ids (sess_...) and generation-derived ids (gen_...). Note that a session-derived id is always sess_ + the sanitized session key, which is not necessarily the raw session id you sent. Using the same container_id from both the bash and shell tools shares the same files, with last-write-wins when both flush concurrently. A fresh name creates a new persistent container. Containers are always scoped to your account and workspace.
      */
     containerId: string;
+    /**
+     * Workspace file ids (or_file_…) to attach into the container before the first command runs. Each file is copied to the container home as a writable copy named {last 8 characters of the file id}-{base filename} (a file stored as data/report.csv with id or_file_…NR6q4V8w attaches to ~/NR6q4V8w-report.csv), so same-named files never collide; the source document is never modified. Unknown, foreign, or malformed ids fail the request with a 400 before any command executes. Max 20 ids.
+     */
+    fileIds?: Array<string> | undefined;
     /**
      * Network egress policy for the container. "disabled" blocks all outbound internet; "allowlist" permits only hosts matching the listed hostnames or * glob patterns (ports 80/443, DNS via Cloudflare resolvers). The policy is fixed when a container starts: sending a different policy to a warm container fails the request with a 409. Omitted: defaults to "disabled" (no outbound internet). For unrestricted egress, use an allowlist of ["*"].
      */
@@ -17,6 +21,7 @@ export type ContainerReferenceEnvironment = {
 /** @internal */
 export type ContainerReferenceEnvironment$Outbound = {
     container_id: string;
+    file_ids?: Array<string> | undefined;
     network_policy?: ContainerNetworkPolicy$Outbound | undefined;
     type: "container_reference";
 };

package/esm/models/containerreferenceenvironment.js

@@ -8,11 +8,13 @@ import { ContainerNetworkPolicy$outboundSchema, } from "./containernetworkpolicy
 /** @internal */
 export const ContainerReferenceEnvironment$outboundSchema = z.object({
     containerId: z.string(),
+    fileIds: z.array(z.string()).optional(),
     networkPolicy: ContainerNetworkPolicy$outboundSchema.optional(),
     type: z.literal("container_reference"),
 }).transform((v) => {
     return remap$(v, {
         containerId: "container_id",
+        fileIds: "file_ids",
         networkPolicy: "network_policy",
     });
 });

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

@@ -86,6 +86,7 @@ export * from "./listvideosmodels.js";
 export * from "./listworkspacebudgets.js";
 export * from "./listworkspacemembers.js";
 export * from "./listworkspaces.js";
+export * from "./promotecontainerfile.js";
 export * from "./queryanalytics.js";
 export * from "./sendchatcompletionrequest.js";
 export * from "./submitgenerationfeedback.js";

package/esm/models/operations/index.js

@@ -90,6 +90,7 @@ export * from "./listvideosmodels.js";
 export * from "./listworkspacebudgets.js";
 export * from "./listworkspacemembers.js";
 export * from "./listworkspaces.js";
+export * from "./promotecontainerfile.js";
 export * from "./queryanalytics.js";
 export * from "./sendchatcompletionrequest.js";
 export * from "./submitgenerationfeedback.js";

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

@@ -0,0 +1,63 @@
+import * as z from "zod/v4";
+export type PromoteContainerFileGlobals = {
+    /**
+     * 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 PromoteContainerFileRequest = {
+    /**
+     * 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 canonical container id, exactly as returned in a bash/shell tool result — a restarted session has its own `-r<nonce>`-suffixed id. A session-derived id is always `sess_` + the sanitized session key, which is not necessarily the raw session id that was sent.
+     */
+    containerId: string;
+    /**
+     * Container file id (`cfile_` + base64url of the file path).
+     */
+    fileId: string;
+};
+/** @internal */
+export type PromoteContainerFileRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    container_id: string;
+    file_id: string;
+};
+/** @internal */
+export declare const PromoteContainerFileRequest$outboundSchema: z.ZodType<PromoteContainerFileRequest$Outbound, PromoteContainerFileRequest>;
+export declare function promoteContainerFileRequestToJSON(promoteContainerFileRequest: PromoteContainerFileRequest): string;
+//# sourceMappingURL=promotecontainerfile.d.ts.map

package/esm/models/operations/promotecontainerfile.js

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

package/esm/sdk/containers.d.ts

@@ -23,5 +23,12 @@ export declare class Containers extends ClientSDK {
      * Streams the raw bytes of a file in a container.
      */
     downloadContainerFileContent(request: operations.DownloadContainerFileContentRequest, options?: RequestOptions): Promise<ReadableStream<Uint8Array>>;
+    /**
+     * Promote a container file into workspace documents
+     *
+     * @remarks
+     * Copies a file from the container's sandbox prefix into the workspace's durable document storage, so it outlives the container. Returns the new document in the Files API shape, with a durable file id in the documents namespace. The copy counts against the workspace's storage quota exactly like an upload.
+     */
+    promoteContainerFile(request: operations.PromoteContainerFileRequest, options?: RequestOptions): Promise<models.FileResponse>;
 }
 //# sourceMappingURL=containers.d.ts.map

package/esm/sdk/containers.js

@@ -5,6 +5,7 @@
 import { containersDownloadContainerFileContent } from "../funcs/containersDownloadContainerFileContent.js";
 import { containersGetContainerFile } from "../funcs/containersGetContainerFile.js";
 import { containersListContainerFiles } from "../funcs/containersListContainerFiles.js";
+import { containersPromoteContainerFile } from "../funcs/containersPromoteContainerFile.js";
 import { ClientSDK } from "../lib/sdks.js";
 import { unwrapAsync } from "../types/fp.js";
 export class Containers extends ClientSDK {
@@ -35,5 +36,14 @@ export class Containers extends ClientSDK {
     async downloadContainerFileContent(request, options) {
         return unwrapAsync(containersDownloadContainerFileContent(this, request, options));
     }
+    /**
+     * Promote a container file into workspace documents
+     *
+     * @remarks
+     * Copies a file from the container's sandbox prefix into the workspace's durable document storage, so it outlives the container. Returns the new document in the Files API shape, with a durable file id in the documents namespace. The copy counts against the workspace's storage quota exactly like an upload.
+     */
+    async promoteContainerFile(request, options) {
+        return unwrapAsync(containersPromoteContainerFile(this, request, options));
+    }
 }
 //# sourceMappingURL=containers.js.map

package/jsr.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "1.2.63",
+  "version": "1.2.65",
   "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": [
@@ -21,8 +21,8 @@
   "license": "Apache-2.0",
   "packageManager": "pnpm@10.22.0",
   "publishConfig": {
-    "provenance": true,
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "type": "module",
   "main": "./esm/index.js",
@@ -73,15 +73,15 @@
     "lint": "eslint --cache --max-warnings=0 src",
     "build": "tsc",
     "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "typecheck:transit": "exit 0",
+    "prepare": "npm run build",
+    "test": "vitest --run --project unit",
     "test:watch": "vitest --watch --project unit",
     "compile": "tsc",
     "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",
-    "typecheck": "tsc --noEmit",
-    "typecheck:transit": "exit 0"
+    "test:transit": "exit 0"
   },
   "peerDependencies": {},
   "devDependencies": {