@meetkai/mka1 0.55.23 → 0.55.25

package/src/models/components/codeinterpretercontainerauto.ts

@@ -8,6 +8,11 @@ import { safeParse } from "../../lib/schemas.js";
 import { ClosedEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  SandboxSessionScope,
+  SandboxSessionScope$inboundSchema,
+  SandboxSessionScope$outboundSchema,
+} from "./sandboxsessionscope.js";
 
 export const MemoryLimit = {
   FiveHundredAndTwelvem: "512m",
@@ -21,6 +26,10 @@ export type MemoryLimit = ClosedEnum<typeof MemoryLimit>;
 
 export type CodeInterpreterContainerAuto = {
   type: "auto";
+  /**
+   * Workspace lifetime. conversation (default) reuses the conversation or previous_response_id chain workspace; independent top-level responses start fresh. Delegated agents inherit their parent's workspace by default without inheriting its conversation history. request starts a fresh workspace for this response and its default-scoped delegated agents. Explicit child request scope or container IDs override inheritance.
+   */
+  sessionScope?: SandboxSessionScope | undefined;
   fileIds?: Array<string> | null | undefined;
   /**
    * Guest memory cap. New requests support 512m, 1g, or 2g; larger legacy values remain readable only in historical responses.
@@ -42,10 +51,12 @@ export const CodeInterpreterContainerAuto$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   type: z.literal("auto"),
+  session_scope: SandboxSessionScope$inboundSchema.optional(),
   file_ids: z.nullable(z.array(z.string())).optional(),
   memory_limit: z.nullable(MemoryLimit$inboundSchema).optional(),
 }).transform((v) => {
   return remap$(v, {
+    "session_scope": "sessionScope",
     "file_ids": "fileIds",
     "memory_limit": "memoryLimit",
   });
@@ -53,6 +64,7 @@ export const CodeInterpreterContainerAuto$inboundSchema: z.ZodType<
 /** @internal */
 export type CodeInterpreterContainerAuto$Outbound = {
   type: "auto";
+  session_scope?: string | undefined;
   file_ids?: Array<string> | null | undefined;
   memory_limit?: string | null | undefined;
 };
@@ -64,10 +76,12 @@ export const CodeInterpreterContainerAuto$outboundSchema: z.ZodType<
   CodeInterpreterContainerAuto
 > = z.object({
   type: z.literal("auto"),
+  sessionScope: SandboxSessionScope$outboundSchema.optional(),
   fileIds: z.nullable(z.array(z.string())).optional(),
   memoryLimit: z.nullable(MemoryLimit$outboundSchema).optional(),
 }).transform((v) => {
   return remap$(v, {
+    sessionScope: "session_scope",
     fileIds: "file_ids",
     memoryLimit: "memory_limit",
   });

package/src/models/components/codeinterpretertoolrequest.ts

@@ -8,6 +8,11 @@ import { safeParse } from "../../lib/schemas.js";
 import { ClosedEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  SandboxSessionScope,
+  SandboxSessionScope$inboundSchema,
+  SandboxSessionScope$outboundSchema,
+} from "./sandboxsessionscope.js";
 
 export const ContainerMemoryLimit = {
   FiveHundredAndTwelvem: "512m",
@@ -18,6 +23,10 @@ export type ContainerMemoryLimit = ClosedEnum<typeof ContainerMemoryLimit>;
 
 export type Container2 = {
   type: "auto";
+  /**
+   * Workspace lifetime. conversation (default) reuses the conversation or previous_response_id chain workspace; independent top-level responses start fresh. Delegated agents inherit their parent's workspace by default without inheriting its conversation history. request starts a fresh workspace for this response and its default-scoped delegated agents. Explicit child request scope or container IDs override inheritance.
+   */
+  sessionScope?: SandboxSessionScope | undefined;
   fileIds?: Array<string> | null | undefined;
   /**
    * Hard guest cap: 512 MiB, 1 GiB, or 2 GiB. Omit for automatic sizing; an explicit cap never grows.
@@ -48,10 +57,12 @@ export const Container2$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   type: z.literal("auto"),
+  session_scope: SandboxSessionScope$inboundSchema.optional(),
   file_ids: z.nullable(z.array(z.string())).optional(),
   memory_limit: z.nullable(ContainerMemoryLimit$inboundSchema).optional(),
 }).transform((v) => {
   return remap$(v, {
+    "session_scope": "sessionScope",
     "file_ids": "fileIds",
     "memory_limit": "memoryLimit",
   });
@@ -59,6 +70,7 @@ export const Container2$inboundSchema: z.ZodType<
 /** @internal */
 export type Container2$Outbound = {
   type: "auto";
+  session_scope?: string | undefined;
   file_ids?: Array<string> | null | undefined;
   memory_limit?: string | null | undefined;
 };
@@ -70,10 +82,12 @@ export const Container2$outboundSchema: z.ZodType<
   Container2
 > = z.object({
   type: z.literal("auto"),
+  sessionScope: SandboxSessionScope$outboundSchema.optional(),
   fileIds: z.nullable(z.array(z.string())).optional(),
   memoryLimit: z.nullable(ContainerMemoryLimit$outboundSchema).optional(),
 }).transform((v) => {
   return remap$(v, {
+    sessionScope: "session_scope",
     fileIds: "file_ids",
     memoryLimit: "memory_limit",
   });

package/src/models/components/createagentrequest.ts

@@ -5,6 +5,7 @@
 import * as z from "zod/v3";
 import { remap as remap$ } from "../../lib/primitives.js";
 import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 import {
@@ -26,6 +27,20 @@ import {
   ToolDefinition$outboundSchema,
 } from "./tooldefinition.js";
 
+/**
+ * What a run beyond max_concurrent_runs gets. reject (the default) refuses it with 429 and error code agent_concurrency_limit. queue stores it as waiting and starts it, oldest first, when a run finishes, with the agent configuration current at that time.
+ */
+export const CreateAgentRequestConcurrencyOverflow = {
+  Reject: "reject",
+  Queue: "queue",
+} as const;
+/**
+ * What a run beyond max_concurrent_runs gets. reject (the default) refuses it with 429 and error code agent_concurrency_limit. queue stores it as waiting and starts it, oldest first, when a run finishes, with the agent configuration current at that time.
+ */
+export type CreateAgentRequestConcurrencyOverflow = ClosedEnum<
+  typeof CreateAgentRequestConcurrencyOverflow
+>;
+
 export type CreateAgentRequest = {
   name: string;
   description?: string | null | undefined;
@@ -42,11 +57,29 @@ export type CreateAgentRequest = {
    * Ordered chain of model IDs the gateway tries when a model call fails on the model before it; forwarded unchanged to the Responses API, which validates it. Empty (the default) means the run keeps the gateway's own fallback rules for the model.
    */
   fallbackModels?: Array<string> | undefined;
+  /**
+   * Most runs of this agent that may execute at once. Null (the default) means no limit. Not part of the versioned configuration: a rollback keeps the current limit, and changing only this field or concurrency_overflow creates no new version.
+   */
+  maxConcurrentRuns?: number | null | undefined;
+  /**
+   * What a run beyond max_concurrent_runs gets. reject (the default) refuses it with 429 and error code agent_concurrency_limit. queue stores it as waiting and starts it, oldest first, when a run finishes, with the agent configuration current at that time.
+   */
+  concurrencyOverflow?: CreateAgentRequestConcurrencyOverflow | undefined;
   text?: AgentTextConfiguration | null | undefined;
   reasoning?: AgentReasoningConfiguration | null | undefined;
   metadata?: { [k: string]: string } | undefined;
 };
 
+/** @internal */
+export const CreateAgentRequestConcurrencyOverflow$inboundSchema:
+  z.ZodNativeEnum<typeof CreateAgentRequestConcurrencyOverflow> = z.nativeEnum(
+    CreateAgentRequestConcurrencyOverflow,
+  );
+/** @internal */
+export const CreateAgentRequestConcurrencyOverflow$outboundSchema:
+  z.ZodNativeEnum<typeof CreateAgentRequestConcurrencyOverflow> =
+    CreateAgentRequestConcurrencyOverflow$inboundSchema;
+
 /** @internal */
 export const CreateAgentRequest$inboundSchema: z.ZodType<
   CreateAgentRequest,
@@ -62,6 +95,9 @@ export const CreateAgentRequest$inboundSchema: z.ZodType<
   parallel_tool_calls: z.boolean().default(true),
   max_tool_calls: z.nullable(z.number().int()).optional(),
   fallback_models: z.array(z.string()).optional(),
+  max_concurrent_runs: z.nullable(z.number().int()).optional(),
+  concurrency_overflow: CreateAgentRequestConcurrencyOverflow$inboundSchema
+    .optional(),
   text: z.nullable(AgentTextConfiguration$inboundSchema).optional(),
   reasoning: z.nullable(AgentReasoningConfiguration$inboundSchema).optional(),
   metadata: z.record(z.string()).optional(),
@@ -71,6 +107,8 @@ export const CreateAgentRequest$inboundSchema: z.ZodType<
     "parallel_tool_calls": "parallelToolCalls",
     "max_tool_calls": "maxToolCalls",
     "fallback_models": "fallbackModels",
+    "max_concurrent_runs": "maxConcurrentRuns",
+    "concurrency_overflow": "concurrencyOverflow",
   });
 });
 /** @internal */
@@ -84,6 +122,8 @@ export type CreateAgentRequest$Outbound = {
   parallel_tool_calls: boolean;
   max_tool_calls?: number | null | undefined;
   fallback_models?: Array<string> | undefined;
+  max_concurrent_runs?: number | null | undefined;
+  concurrency_overflow?: string | undefined;
   text?: AgentTextConfiguration$Outbound | null | undefined;
   reasoning?: AgentReasoningConfiguration$Outbound | null | undefined;
   metadata?: { [k: string]: string } | undefined;
@@ -104,6 +144,9 @@ export const CreateAgentRequest$outboundSchema: z.ZodType<
   parallelToolCalls: z.boolean().default(true),
   maxToolCalls: z.nullable(z.number().int()).optional(),
   fallbackModels: z.array(z.string()).optional(),
+  maxConcurrentRuns: z.nullable(z.number().int()).optional(),
+  concurrencyOverflow: CreateAgentRequestConcurrencyOverflow$outboundSchema
+    .optional(),
   text: z.nullable(AgentTextConfiguration$outboundSchema).optional(),
   reasoning: z.nullable(AgentReasoningConfiguration$outboundSchema).optional(),
   metadata: z.record(z.string()).optional(),
@@ -113,6 +156,8 @@ export const CreateAgentRequest$outboundSchema: z.ZodType<
     parallelToolCalls: "parallel_tool_calls",
     maxToolCalls: "max_tool_calls",
     fallbackModels: "fallback_models",
+    maxConcurrentRuns: "max_concurrent_runs",
+    concurrencyOverflow: "concurrency_overflow",
   });
 });
 

package/src/models/components/index.ts

@@ -25,6 +25,7 @@ export * from "./agentschedule.js";
 export * from "./agentschedulelist.js";
 export * from "./agentschedulespec.js";
 export * from "./agentsfunctiontooldefinition.js";
+export * from "./agentssandboxsessionscope.js";
 export * from "./agenttextconfiguration.js";
 export * from "./agenttooldefinition.js";
 export * from "./agentversion.js";
@@ -68,6 +69,7 @@ export * from "./catalogactivationstate.js";
 export * from "./catalogentry.js";
 export * from "./cataloghealth.js";
 export * from "./cataloghealthresponse.js";
+export * from "./cataloghealthstatus.js";
 export * from "./cataloglifecycle.js";
 export * from "./cataloglistresponse.js";
 export * from "./catalogpricepreview.js";
@@ -710,6 +712,7 @@ export * from "./shellenvironmentcontainerreference.js";
 export * from "./shellnetworkpolicy.js";
 export * from "./shellnetworkpolicydomainsecret.js";
 export * from "./shelltooldefinition.js";
+export * from "./shelltoolrequest.js";
 export * from "./skill.js";
 export * from "./skillentry.js";
 export * from "./skilllist.js";

package/src/models/components/livekittokenrequest.ts

@@ -99,11 +99,11 @@ import {
   ReasoningConfiguration$outboundSchema,
 } from "./reasoningconfiguration.js";
 import {
-  ShellToolDefinition,
-  ShellToolDefinition$inboundSchema,
-  ShellToolDefinition$Outbound,
-  ShellToolDefinition$outboundSchema,
-} from "./shelltooldefinition.js";
+  ShellToolRequest,
+  ShellToolRequest$inboundSchema,
+  ShellToolRequest$Outbound,
+  ShellToolRequest$outboundSchema,
+} from "./shelltoolrequest.js";
 import {
   SleepToolDefinition,
   SleepToolDefinition$inboundSchema,
@@ -154,7 +154,7 @@ export type LivekitTokenRequestTools =
   | MCPToolDefinition
   | ImageGenerationToolDefinition
   | LocalShellToolDefinition
-  | ShellToolDefinition
+  | ShellToolRequest
   | WebSearchPreviewToolDefinition
   | HostedToolShorthandDefinition
   | SleepToolDefinition
@@ -226,7 +226,7 @@ export type Llm = {
       | MCPToolDefinition
       | ImageGenerationToolDefinition
       | LocalShellToolDefinition
-      | ShellToolDefinition
+      | ShellToolRequest
       | WebSearchPreviewToolDefinition
       | HostedToolShorthandDefinition
       | SleepToolDefinition
@@ -279,7 +279,7 @@ export type Llm = {
    */
   serviceTier?: LivekitTokenRequestServiceTier | undefined;
   /**
-   * Custom metadata to attach to this response as key-value pairs. Keys must be strings up to 64 characters, values must be strings up to 512 characters. Maximum 16 pairs. Useful for tracking, categorization, or passing custom identifiers through your system.
+   * Custom metadata to attach to this response as key-value pairs. Keys must be strings up to 64 characters, values must be strings up to 512 characters. Maximum 16 pairs, excluding invocation workspace linkage. Useful for tracking, categorization, or passing custom identifiers through your system.
    */
   metadata?: { [k: string]: string } | undefined;
   text?: TextConfiguration | undefined;
@@ -390,7 +390,7 @@ export const LivekitTokenRequestTools$inboundSchema: z.ZodType<
   MCPToolDefinition$inboundSchema,
   ImageGenerationToolDefinition$inboundSchema,
   LocalShellToolDefinition$inboundSchema,
-  ShellToolDefinition$inboundSchema,
+  ShellToolRequest$inboundSchema,
   WebSearchPreviewToolDefinition$inboundSchema,
   HostedToolShorthandDefinition$inboundSchema,
   SleepToolDefinition$inboundSchema,
@@ -408,7 +408,7 @@ export type LivekitTokenRequestTools$Outbound =
   | MCPToolDefinition$Outbound
   | ImageGenerationToolDefinition$Outbound
   | LocalShellToolDefinition$Outbound
-  | ShellToolDefinition$Outbound
+  | ShellToolRequest$Outbound
   | WebSearchPreviewToolDefinition$Outbound
   | HostedToolShorthandDefinition$Outbound
   | SleepToolDefinition$Outbound
@@ -430,7 +430,7 @@ export const LivekitTokenRequestTools$outboundSchema: z.ZodType<
   MCPToolDefinition$outboundSchema,
   ImageGenerationToolDefinition$outboundSchema,
   LocalShellToolDefinition$outboundSchema,
-  ShellToolDefinition$outboundSchema,
+  ShellToolRequest$outboundSchema,
   WebSearchPreviewToolDefinition$outboundSchema,
   HostedToolShorthandDefinition$outboundSchema,
   SleepToolDefinition$outboundSchema,
@@ -493,7 +493,7 @@ export const Llm$inboundSchema: z.ZodType<Llm, z.ZodTypeDef, unknown> = z
         MCPToolDefinition$inboundSchema,
         ImageGenerationToolDefinition$inboundSchema,
         LocalShellToolDefinition$inboundSchema,
-        ShellToolDefinition$inboundSchema,
+        ShellToolRequest$inboundSchema,
         WebSearchPreviewToolDefinition$inboundSchema,
         HostedToolShorthandDefinition$inboundSchema,
         SleepToolDefinition$inboundSchema,
@@ -548,7 +548,7 @@ export type Llm$Outbound = {
       | MCPToolDefinition$Outbound
       | ImageGenerationToolDefinition$Outbound
       | LocalShellToolDefinition$Outbound
-      | ShellToolDefinition$Outbound
+      | ShellToolRequest$Outbound
       | WebSearchPreviewToolDefinition$Outbound
       | HostedToolShorthandDefinition$Outbound
       | SleepToolDefinition$Outbound
@@ -592,7 +592,7 @@ export const Llm$outboundSchema: z.ZodType<Llm$Outbound, z.ZodTypeDef, Llm> = z
         MCPToolDefinition$outboundSchema,
         ImageGenerationToolDefinition$outboundSchema,
         LocalShellToolDefinition$outboundSchema,
-        ShellToolDefinition$outboundSchema,
+        ShellToolRequest$outboundSchema,
         WebSearchPreviewToolDefinition$outboundSchema,
         HostedToolShorthandDefinition$outboundSchema,
         SleepToolDefinition$outboundSchema,

package/src/models/components/responsescreaterequest.ts

@@ -105,11 +105,11 @@ import {
   ReasoningConfiguration$outboundSchema,
 } from "./reasoningconfiguration.js";
 import {
-  ShellToolDefinition,
-  ShellToolDefinition$inboundSchema,
-  ShellToolDefinition$Outbound,
-  ShellToolDefinition$outboundSchema,
-} from "./shelltooldefinition.js";
+  ShellToolRequest,
+  ShellToolRequest$inboundSchema,
+  ShellToolRequest$Outbound,
+  ShellToolRequest$outboundSchema,
+} from "./shelltoolrequest.js";
 import {
   SleepToolDefinition,
   SleepToolDefinition$inboundSchema,
@@ -181,7 +181,7 @@ export type Tools =
   | MCPToolDefinition
   | ImageGenerationToolDefinition
   | LocalShellToolDefinition
-  | ShellToolDefinition
+  | ShellToolRequest
   | WebSearchPreviewToolDefinition
   | HostedToolShorthandDefinition
   | SleepToolDefinition
@@ -341,7 +341,7 @@ export type ResponsesCreateRequest = {
       | MCPToolDefinition
       | ImageGenerationToolDefinition
       | LocalShellToolDefinition
-      | ShellToolDefinition
+      | ShellToolRequest
       | WebSearchPreviewToolDefinition
       | HostedToolShorthandDefinition
       | SleepToolDefinition
@@ -442,7 +442,7 @@ export type ResponsesCreateRequest = {
    */
   safetyIdentifier?: string | undefined;
   /**
-   * Custom metadata to attach to this response as key-value pairs. Keys must be strings up to 64 characters, values must be strings up to 512 characters. Maximum 16 pairs. Useful for tracking, categorization, or passing custom identifiers through your system.
+   * Custom metadata to attach to this response as key-value pairs. Keys must be strings up to 64 characters, values must be strings up to 512 characters. Maximum 16 pairs, excluding invocation workspace linkage. Useful for tracking, categorization, or passing custom identifiers through your system.
    */
   metadata?: { [k: string]: string } | undefined;
   /**
@@ -609,7 +609,7 @@ export const Tools$inboundSchema: z.ZodType<Tools, z.ZodTypeDef, unknown> = z
     MCPToolDefinition$inboundSchema,
     ImageGenerationToolDefinition$inboundSchema,
     LocalShellToolDefinition$inboundSchema,
-    ShellToolDefinition$inboundSchema,
+    ShellToolRequest$inboundSchema,
     WebSearchPreviewToolDefinition$inboundSchema,
     HostedToolShorthandDefinition$inboundSchema,
     SleepToolDefinition$inboundSchema,
@@ -627,7 +627,7 @@ export type Tools$Outbound =
   | MCPToolDefinition$Outbound
   | ImageGenerationToolDefinition$Outbound
   | LocalShellToolDefinition$Outbound
-  | ShellToolDefinition$Outbound
+  | ShellToolRequest$Outbound
   | WebSearchPreviewToolDefinition$Outbound
   | HostedToolShorthandDefinition$Outbound
   | SleepToolDefinition$Outbound
@@ -649,7 +649,7 @@ export const Tools$outboundSchema: z.ZodType<
   MCPToolDefinition$outboundSchema,
   ImageGenerationToolDefinition$outboundSchema,
   LocalShellToolDefinition$outboundSchema,
-  ShellToolDefinition$outboundSchema,
+  ShellToolRequest$outboundSchema,
   WebSearchPreviewToolDefinition$outboundSchema,
   HostedToolShorthandDefinition$outboundSchema,
   SleepToolDefinition$outboundSchema,
@@ -844,7 +844,7 @@ export const ResponsesCreateRequest$inboundSchema: z.ZodType<
       MCPToolDefinition$inboundSchema,
       ImageGenerationToolDefinition$inboundSchema,
       LocalShellToolDefinition$inboundSchema,
-      ShellToolDefinition$inboundSchema,
+      ShellToolRequest$inboundSchema,
       WebSearchPreviewToolDefinition$inboundSchema,
       HostedToolShorthandDefinition$inboundSchema,
       SleepToolDefinition$inboundSchema,
@@ -943,7 +943,7 @@ export type ResponsesCreateRequest$Outbound = {
       | MCPToolDefinition$Outbound
       | ImageGenerationToolDefinition$Outbound
       | LocalShellToolDefinition$Outbound
-      | ShellToolDefinition$Outbound
+      | ShellToolRequest$Outbound
       | WebSearchPreviewToolDefinition$Outbound
       | HostedToolShorthandDefinition$Outbound
       | SleepToolDefinition$Outbound
@@ -1017,7 +1017,7 @@ export const ResponsesCreateRequest$outboundSchema: z.ZodType<
       MCPToolDefinition$outboundSchema,
       ImageGenerationToolDefinition$outboundSchema,
       LocalShellToolDefinition$outboundSchema,
-      ShellToolDefinition$outboundSchema,
+      ShellToolRequest$outboundSchema,
       WebSearchPreviewToolDefinition$outboundSchema,
       HostedToolShorthandDefinition$outboundSchema,
       SleepToolDefinition$outboundSchema,

package/src/models/components/sandboxsessionscope.ts

@@ -6,14 +6,14 @@ import * as z from "zod/v3";
 import { ClosedEnum } from "../../types/enums.js";
 
 /**
- * Workspace lifetime. conversation (default) keeps files within the same conversation or response chain. Delegated agents inherit their parent's workspace without its conversation history. request starts a fresh workspace for this response and its default-scoped delegated agents. Explicit child request scope or container IDs override inheritance. Independent top-level responses start fresh.
+ * Workspace lifetime. conversation (default) reuses the conversation or previous_response_id chain workspace; independent top-level responses start fresh. Delegated agents inherit their parent's workspace by default without inheriting its conversation history. request starts a fresh workspace for this response and its default-scoped delegated agents. Explicit child request scope or container IDs override inheritance.
  */
 export const SandboxSessionScope = {
   Conversation: "conversation",
   Request: "request",
 } as const;
 /**
- * Workspace lifetime. conversation (default) keeps files within the same conversation or response chain. Delegated agents inherit their parent's workspace without its conversation history. request starts a fresh workspace for this response and its default-scoped delegated agents. Explicit child request scope or container IDs override inheritance. Independent top-level responses start fresh.
+ * Workspace lifetime. conversation (default) reuses the conversation or previous_response_id chain workspace; independent top-level responses start fresh. Delegated agents inherit their parent's workspace by default without inheriting its conversation history. request starts a fresh workspace for this response and its default-scoped delegated agents. Explicit child request scope or container IDs override inheritance.
  */
 export type SandboxSessionScope = ClosedEnum<typeof SandboxSessionScope>;
 

package/src/models/components/shellenvironmentcontainerauto.ts

@@ -13,6 +13,11 @@ import {
   MemoryStoreMount$Outbound,
   MemoryStoreMount$outboundSchema,
 } from "./memorystoremount.js";
+import {
+  SandboxSessionScope,
+  SandboxSessionScope$inboundSchema,
+  SandboxSessionScope$outboundSchema,
+} from "./sandboxsessionscope.js";
 import {
   ShellNetworkPolicy,
   ShellNetworkPolicy$inboundSchema,
@@ -28,6 +33,10 @@ import {
 
 export type ShellEnvironmentContainerAuto = {
   type: "container_auto";
+  /**
+   * Workspace lifetime. conversation (default) reuses the conversation or previous_response_id chain workspace; independent top-level responses start fresh. Delegated agents inherit their parent's workspace by default without inheriting its conversation history. request starts a fresh workspace for this response and its default-scoped delegated agents. Explicit child request scope or container IDs override inheritance.
+   */
+  sessionScope?: SandboxSessionScope | undefined;
   networkPolicy?: ShellNetworkPolicy | undefined;
   /**
    * Skills to inject into the container's /skills directory.
@@ -46,11 +55,13 @@ export const ShellEnvironmentContainerAuto$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   type: z.literal("container_auto"),
+  session_scope: SandboxSessionScope$inboundSchema.optional(),
   network_policy: ShellNetworkPolicy$inboundSchema.optional(),
   skills: z.array(SkillEntry$inboundSchema).optional(),
   memory_stores: z.array(MemoryStoreMount$inboundSchema).optional(),
 }).transform((v) => {
   return remap$(v, {
+    "session_scope": "sessionScope",
     "network_policy": "networkPolicy",
     "memory_stores": "memoryStores",
   });
@@ -58,6 +69,7 @@ export const ShellEnvironmentContainerAuto$inboundSchema: z.ZodType<
 /** @internal */
 export type ShellEnvironmentContainerAuto$Outbound = {
   type: "container_auto";
+  session_scope?: string | undefined;
   network_policy?: ShellNetworkPolicy$Outbound | undefined;
   skills?: Array<SkillEntry$Outbound> | undefined;
   memory_stores?: Array<MemoryStoreMount$Outbound> | undefined;
@@ -70,11 +82,13 @@ export const ShellEnvironmentContainerAuto$outboundSchema: z.ZodType<
   ShellEnvironmentContainerAuto
 > = z.object({
   type: z.literal("container_auto"),
+  sessionScope: SandboxSessionScope$outboundSchema.optional(),
   networkPolicy: ShellNetworkPolicy$outboundSchema.optional(),
   skills: z.array(SkillEntry$outboundSchema).optional(),
   memoryStores: z.array(MemoryStoreMount$outboundSchema).optional(),
 }).transform((v) => {
   return remap$(v, {
+    sessionScope: "session_scope",
     networkPolicy: "network_policy",
     memoryStores: "memory_stores",
   });