@openrouter/sdk 1.2.54 → 1.2.56

package/esm/models/containerreferenceenvironment.d.ts

@@ -1,10 +1,10 @@
 import * as z from "zod/v4";
 /**
- * Reference to a previously created container to reuse.
+ * Reference to a container by its canonical id — a previously returned container_id or a fresh name to create a persistent container.
  */
 export type ContainerReferenceEnvironment = {
     /**
-     * Identifier of an existing container to reuse (max 20 characters).
+     * 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;
     type: "container_reference";

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/messagesbashtoolresultblock.d.ts

@@ -1,19 +1,56 @@
 import * as z from "zod/v4";
+import { ClosedEnum } from "../types/enums.js";
+export declare const MessagesBashToolResultBlockTypeContainerFileCitation: {
+    readonly ContainerFileCitation: "container_file_citation";
+};
+export type MessagesBashToolResultBlockTypeContainerFileCitation = ClosedEnum<typeof MessagesBashToolResultBlockTypeContainerFileCitation>;
+export type MessagesBashToolResultBlockFile = {
+    containerId: string;
+    endIndex: number;
+    fileId: string;
+    filename: string;
+    startIndex: number;
+    type: MessagesBashToolResultBlockTypeContainerFileCitation;
+};
 /**
  * Output of a sandbox-executed `openrouter:bash` call from a prior assistant turn. Accepted on replay and dropped before the provider request — Anthropic has no equivalent block.
  */
 export type MessagesBashToolResultBlock = {
+    /**
+     * The canonical container id the command ran under — the `{container_id}` for the Container Files API, reusable as a `container_reference` in later requests. Present on every sandbox-executed call, even when no files changed.
+     */
+    containerId?: string | undefined;
     content: {
         [k: string]: any;
     };
+    /**
+     * Citations for the files the sandbox command created or modified, most-recently-touched first (at most 10). Retrieve them via the Container Files API.
+     */
+    files?: Array<MessagesBashToolResultBlockFile> | undefined;
     toolUseId: string;
     type: "openrouter_bash_tool_result";
 };
 /** @internal */
+export declare const MessagesBashToolResultBlockTypeContainerFileCitation$outboundSchema: z.ZodEnum<typeof MessagesBashToolResultBlockTypeContainerFileCitation>;
+/** @internal */
+export type MessagesBashToolResultBlockFile$Outbound = {
+    container_id: string;
+    end_index: number;
+    file_id: string;
+    filename: string;
+    start_index: number;
+    type: string;
+};
+/** @internal */
+export declare const MessagesBashToolResultBlockFile$outboundSchema: z.ZodType<MessagesBashToolResultBlockFile$Outbound, MessagesBashToolResultBlockFile>;
+export declare function messagesBashToolResultBlockFileToJSON(messagesBashToolResultBlockFile: MessagesBashToolResultBlockFile): string;
+/** @internal */
 export type MessagesBashToolResultBlock$Outbound = {
+    container_id?: string | undefined;
     content: {
         [k: string]: any;
     };
+    files?: Array<MessagesBashToolResultBlockFile$Outbound> | undefined;
     tool_use_id: string;
     type: "openrouter_bash_tool_result";
 };

package/esm/models/messagesbashtoolresultblock.js

@@ -4,13 +4,42 @@
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";
+export const MessagesBashToolResultBlockTypeContainerFileCitation = {
+    ContainerFileCitation: "container_file_citation",
+};
+/** @internal */
+export const MessagesBashToolResultBlockTypeContainerFileCitation$outboundSchema = z
+    .enum(MessagesBashToolResultBlockTypeContainerFileCitation);
+/** @internal */
+export const MessagesBashToolResultBlockFile$outboundSchema = z.object({
+    containerId: z.string(),
+    endIndex: z.int(),
+    fileId: z.string(),
+    filename: z.string(),
+    startIndex: z.int(),
+    type: MessagesBashToolResultBlockTypeContainerFileCitation$outboundSchema,
+}).transform((v) => {
+    return remap$(v, {
+        containerId: "container_id",
+        endIndex: "end_index",
+        fileId: "file_id",
+        startIndex: "start_index",
+    });
+});
+export function messagesBashToolResultBlockFileToJSON(messagesBashToolResultBlockFile) {
+    return JSON.stringify(MessagesBashToolResultBlockFile$outboundSchema.parse(messagesBashToolResultBlockFile));
+}
 /** @internal */
 export const MessagesBashToolResultBlock$outboundSchema = z.object({
+    containerId: z.string().optional(),
     content: z.record(z.string(), z.any()),
+    files: z.array(z.lazy(() => MessagesBashToolResultBlockFile$outboundSchema))
+        .optional(),
     toolUseId: z.string(),
     type: z.literal("openrouter_bash_tool_result"),
 }).transform((v) => {
     return remap$(v, {
+        containerId: "container_id",
         toolUseId: "tool_use_id",
     });
 });

package/esm/models/messagesshelltoolresultblock.d.ts

@@ -1,19 +1,56 @@
 import * as z from "zod/v4";
+import { ClosedEnum } from "../types/enums.js";
+export declare const MessagesShellToolResultBlockTypeContainerFileCitation: {
+    readonly ContainerFileCitation: "container_file_citation";
+};
+export type MessagesShellToolResultBlockTypeContainerFileCitation = ClosedEnum<typeof MessagesShellToolResultBlockTypeContainerFileCitation>;
+export type MessagesShellToolResultBlockFile = {
+    containerId: string;
+    endIndex: number;
+    fileId: string;
+    filename: string;
+    startIndex: number;
+    type: MessagesShellToolResultBlockTypeContainerFileCitation;
+};
 /**
  * Output of an `openrouter:shell` call from a prior assistant turn. Accepted on replay and dropped before the provider request — Anthropic has no equivalent block.
  */
 export type MessagesShellToolResultBlock = {
+    /**
+     * The canonical container id the command ran under — the `{container_id}` for the Container Files API, reusable as a `container_reference` in later requests. Present on every sandbox-executed call, even when no files changed.
+     */
+    containerId?: string | undefined;
     content: {
         [k: string]: any;
     };
+    /**
+     * Citations for the files the sandbox command created or modified, most-recently-touched first (at most 10). Retrieve them via the Container Files API.
+     */
+    files?: Array<MessagesShellToolResultBlockFile> | undefined;
     toolUseId: string;
     type: "openrouter_shell_tool_result";
 };
 /** @internal */
+export declare const MessagesShellToolResultBlockTypeContainerFileCitation$outboundSchema: z.ZodEnum<typeof MessagesShellToolResultBlockTypeContainerFileCitation>;
+/** @internal */
+export type MessagesShellToolResultBlockFile$Outbound = {
+    container_id: string;
+    end_index: number;
+    file_id: string;
+    filename: string;
+    start_index: number;
+    type: string;
+};
+/** @internal */
+export declare const MessagesShellToolResultBlockFile$outboundSchema: z.ZodType<MessagesShellToolResultBlockFile$Outbound, MessagesShellToolResultBlockFile>;
+export declare function messagesShellToolResultBlockFileToJSON(messagesShellToolResultBlockFile: MessagesShellToolResultBlockFile): string;
+/** @internal */
 export type MessagesShellToolResultBlock$Outbound = {
+    container_id?: string | undefined;
     content: {
         [k: string]: any;
     };
+    files?: Array<MessagesShellToolResultBlockFile$Outbound> | undefined;
     tool_use_id: string;
     type: "openrouter_shell_tool_result";
 };

package/esm/models/messagesshelltoolresultblock.js

@@ -4,13 +4,42 @@
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";
+export const MessagesShellToolResultBlockTypeContainerFileCitation = {
+    ContainerFileCitation: "container_file_citation",
+};
+/** @internal */
+export const MessagesShellToolResultBlockTypeContainerFileCitation$outboundSchema = z
+    .enum(MessagesShellToolResultBlockTypeContainerFileCitation);
+/** @internal */
+export const MessagesShellToolResultBlockFile$outboundSchema = z.object({
+    containerId: z.string(),
+    endIndex: z.int(),
+    fileId: z.string(),
+    filename: z.string(),
+    startIndex: z.int(),
+    type: MessagesShellToolResultBlockTypeContainerFileCitation$outboundSchema,
+}).transform((v) => {
+    return remap$(v, {
+        containerId: "container_id",
+        endIndex: "end_index",
+        fileId: "file_id",
+        startIndex: "start_index",
+    });
+});
+export function messagesShellToolResultBlockFileToJSON(messagesShellToolResultBlockFile) {
+    return JSON.stringify(MessagesShellToolResultBlockFile$outboundSchema.parse(messagesShellToolResultBlockFile));
+}
 /** @internal */
 export const MessagesShellToolResultBlock$outboundSchema = z.object({
+    containerId: z.string().optional(),
     content: z.record(z.string(), z.any()),
+    files: z.array(z.lazy(() => MessagesShellToolResultBlockFile$outboundSchema))
+        .optional(),
     toolUseId: z.string(),
     type: z.literal("openrouter_shell_tool_result"),
 }).transform((v) => {
     return remap$(v, {
+        containerId: "container_id",
         toolUseId: "tool_use_id",
     });
 });

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 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 DownloadContainerFileContentRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    container_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(),
+    containerId: z.string(),
+    fileId: z.string(),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+        containerId: "container_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 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 GetContainerFileRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    container_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(),
+    containerId: z.string(),
+    fileId: z.string(),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+        containerId: "container_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 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;
+    /**
+     * 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;
+    container_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(),
+    containerId: z.string(),
+    limit: z.int().default(100),
+    after: z.string().optional(),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+        containerId: "container_id",
+    });
+});
+export function listContainerFilesRequestToJSON(listContainerFilesRequest) {
+    return JSON.stringify(ListContainerFilesRequest$outboundSchema.parse(listContainerFilesRequest));
+}
+//# sourceMappingURL=listcontainerfiles.js.map

package/esm/models/outputbashservertoolitem.d.ts

@@ -3,10 +3,22 @@ import { ClosedEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
 import { ToolCallStatus } from "./toolcallstatus.js";
-export declare const OutputBashServerToolItemType: {
+export declare const OutputBashServerToolItemTypeContainerFileCitation: {
+    readonly ContainerFileCitation: "container_file_citation";
+};
+export type OutputBashServerToolItemTypeContainerFileCitation = ClosedEnum<typeof OutputBashServerToolItemTypeContainerFileCitation>;
+export type OutputBashServerToolItemFile = {
+    containerId: string;
+    endIndex: number;
+    fileId: string;
+    filename: string;
+    startIndex: number;
+    type: OutputBashServerToolItemTypeContainerFileCitation;
+};
+export declare const OutputBashServerToolItemTypeOpenrouterBash: {
     readonly OpenrouterBash: "openrouter:bash";
 };
-export type OutputBashServerToolItemType = ClosedEnum<typeof OutputBashServerToolItemType>;
+export type OutputBashServerToolItemTypeOpenrouterBash = ClosedEnum<typeof OutputBashServerToolItemTypeOpenrouterBash>;
 /**
  * An openrouter:bash server tool output item
  */
@@ -20,17 +32,44 @@ export type OutputBashServerToolItem = {
      */
     callId?: string | null | undefined;
     command?: string | undefined;
+    /**
+     * The canonical container id the command ran under — the `{container_id}` for the Container Files API, reusable as a `container_reference` in later requests. Present on every sandbox-executed call, even when no files changed.
+     */
+    containerId?: string | undefined;
     exitCode?: number | undefined;
+    /**
+     * Citations for the files the sandbox command created or modified, most-recently-touched first (at most 10). Retrieve them via the Container Files API.
+     */
+    files?: Array<OutputBashServerToolItemFile> | undefined;
     id?: string | undefined;
     status: ToolCallStatus;
     stderr?: string | undefined;
     stdout?: string | undefined;
-    type: OutputBashServerToolItemType;
+    type: OutputBashServerToolItemTypeOpenrouterBash;
 };
 /** @internal */
-export declare const OutputBashServerToolItemType$inboundSchema: z.ZodEnum<typeof OutputBashServerToolItemType>;
+export declare const OutputBashServerToolItemTypeContainerFileCitation$inboundSchema: z.ZodEnum<typeof OutputBashServerToolItemTypeContainerFileCitation>;
+/** @internal */
+export declare const OutputBashServerToolItemTypeContainerFileCitation$outboundSchema: z.ZodEnum<typeof OutputBashServerToolItemTypeContainerFileCitation>;
+/** @internal */
+export declare const OutputBashServerToolItemFile$inboundSchema: z.ZodType<OutputBashServerToolItemFile, unknown>;
+/** @internal */
+export type OutputBashServerToolItemFile$Outbound = {
+    container_id: string;
+    end_index: number;
+    file_id: string;
+    filename: string;
+    start_index: number;
+    type: string;
+};
+/** @internal */
+export declare const OutputBashServerToolItemFile$outboundSchema: z.ZodType<OutputBashServerToolItemFile$Outbound, OutputBashServerToolItemFile>;
+export declare function outputBashServerToolItemFileToJSON(outputBashServerToolItemFile: OutputBashServerToolItemFile): string;
+export declare function outputBashServerToolItemFileFromJSON(jsonString: string): SafeParseResult<OutputBashServerToolItemFile, SDKValidationError>;
+/** @internal */
+export declare const OutputBashServerToolItemTypeOpenrouterBash$inboundSchema: z.ZodEnum<typeof OutputBashServerToolItemTypeOpenrouterBash>;
 /** @internal */
-export declare const OutputBashServerToolItemType$outboundSchema: z.ZodEnum<typeof OutputBashServerToolItemType>;
+export declare const OutputBashServerToolItemTypeOpenrouterBash$outboundSchema: z.ZodEnum<typeof OutputBashServerToolItemTypeOpenrouterBash>;
 /** @internal */
 export declare const OutputBashServerToolItem$inboundSchema: z.ZodType<OutputBashServerToolItem, unknown>;
 /** @internal */
@@ -38,7 +77,9 @@ export type OutputBashServerToolItem$Outbound = {
     arguments?: string | null | undefined;
     call_id?: string | null | undefined;
     command?: string | undefined;
+    container_id?: string | undefined;
     exitCode?: number | undefined;
+    files?: Array<OutputBashServerToolItemFile$Outbound> | undefined;
     id?: string | undefined;
     status: string;
     stderr?: string | undefined;