feat: add Apple container workspace sandbox

.changeset/apple-container-sandbox.md

@@ -0,0 +1,15 @@
+---
+'@mastra/apple-container': minor
+---
+
+Add an Apple container CLI workspace sandbox provider.
+
+```ts
+import { AppleContainerSandbox } from '@mastra/apple-container';
+
+const sandbox = new AppleContainerSandbox({
+  id: 'local-apple-container',
+  image: 'node:22-slim',
+  volumes: { [process.cwd()]: '/workspace' },
+});
+```

docs/src/content/en/docs/workspace/sandbox.mdx

@@ -24,6 +24,7 @@ A sandbox provider executes commands in a controlled environment:
 
 - [`LocalSandbox`](/reference/workspace/local-sandbox): Executes commands on the local machine
 - [`AgentCoreRuntimeSandbox`](/reference/workspace/agentcore-runtime-sandbox): Executes commands in AWS Bedrock AgentCore Runtime sessions
+- [`AppleContainerSandbox`](/reference/workspace/apple-container-sandbox): Executes commands in local OCI Linux containers using Apple's `container` CLI
 - [`BlaxelSandbox`](/reference/workspace/blaxel-sandbox): Executes commands in isolated Blaxel cloud sandboxes
 - [`DaytonaSandbox`](/reference/workspace/daytona-sandbox): Executes commands in isolated Daytona cloud sandboxes
 - [`E2BSandbox`](/reference/workspace/e2b-sandbox): Executes commands in isolated E2B cloud sandboxes
@@ -239,6 +240,7 @@ For the full `SandboxProcessManager` API (spawning processes programmatically, r
 
 - [`SandboxProcessManager` reference](/reference/workspace/process-manager)
 - [`AgentCoreRuntimeSandbox` reference](/reference/workspace/agentcore-runtime-sandbox)
+- [`AppleContainerSandbox` reference](/reference/workspace/apple-container-sandbox)
 - [`DaytonaSandbox` reference](/reference/workspace/daytona-sandbox)
 - [`E2BSandbox` reference](/reference/workspace/e2b-sandbox)
 - [`LocalSandbox` reference](/reference/workspace/local-sandbox)

docs/src/content/en/reference/sidebars.js

@@ -773,6 +773,7 @@ const sidebars = {
           label: 'AgentCoreRuntimeSandbox',
         },
         { type: 'doc', id: 'workspace/agentfs-filesystem', label: 'AgentFSFilesystem' },
+        { type: 'doc', id: 'workspace/apple-container-sandbox', label: 'AppleContainerSandbox' },
         { type: 'doc', id: 'workspace/archil-filesystem', label: 'ArchilFilesystem' },
         { type: 'doc', id: 'workspace/azure-blob-filesystem', label: 'AzureBlobFilesystem' },
         { type: 'doc', id: 'workspace/blaxel-sandbox', label: 'BlaxelSandbox' },