diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 0746cbe..e6eadb4 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "2.12.0"
+  ".": "2.13.0"
 }
\ No newline at end of file
diff --git a/.stats.yml b/.stats.yml
index ad6cd80..9aabd7d 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 41
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-2c3f4e4b357ca78c019a3aacd006e2bb8b332d4172a300ee6c46c076a216ed3f.yml
-openapi_spec_hash: b89be415cf6ee594b521885a9deb25ac
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-dc61df29e1b6282f9df685fadd65f3683afe352deccae94d0c080092e0eae4b3.yml
+openapi_spec_hash: 258caa98cd0de5f7149f6937d071c912
 config_hash: 0fb0ceca5946298c416cec0cca5260c7
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5429142..f651bcc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,14 @@
 # Changelog
 
+## 2.13.0 (2026-08-27)
+
+Full Changelog: [v2.12.0...v2.13.0](https://github.com/context-dot-dev/context-php-sdk/compare/v2.12.0...v2.13.0)
+
+### Features
+
+* **api:** api update ([171e0a4](https://github.com/context-dot-dev/context-php-sdk/commit/171e0a46709a9ca96179d7ccd149b3c949ba3e32))
+* **api:** api update ([8254251](https://github.com/context-dot-dev/context-php-sdk/commit/8254251acb0d5a1c933ae6978ab2710cf1163b8a))
+
 ## 2.12.0 (2026-08-23)
 
 Full Changelog: [v2.11.0...v2.12.0](https://github.com/context-dot-dev/context-php-sdk/compare/v2.11.0...v2.12.0)
diff --git a/README.md b/README.md
index be5e105..5577a7c 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,7 @@ The REST API documentation can be found on [docs.context.dev](https://docs.conte
 <!-- x-release-please-start-version -->
 
 ```
-composer require "context-dev/context-dev-php 2.12.0"
+composer require "context-dev/context-dev-php 2.13.0"
 ```
 
 <!-- x-release-please-end -->
@@ -32,7 +32,7 @@ $client = new Client(apiKey: getenv('CONTEXT_DEV_API_KEY') ?: 'My API Key');
 
 $brand = $client->brand->retrieve(domain: 'REPLACE_ME', type: 'by_domain');
 
-var_dump($brand->brand);
+var_dump($brand->cache_metadata);
 ```
 
 ### Value Objects
diff --git a/src/AI/AIExtractProductResponse.php b/src/AI/AIExtractProductResponse.php
index 07f9605..e99b990 100644
--- a/src/AI/AIExtractProductResponse.php
+++ b/src/AI/AIExtractProductResponse.php
@@ -4,18 +4,22 @@
 
 namespace ContextDev\AI;
 
+use ContextDev\AI\AIExtractProductResponse\CacheMetadata;
 use ContextDev\AI\AIExtractProductResponse\KeyMetadata;
 use ContextDev\AI\AIExtractProductResponse\Platform;
 use ContextDev\AI\AIExtractProductResponse\Product;
 use ContextDev\Core\Attributes\Optional;
+use ContextDev\Core\Attributes\Required;
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Contracts\BaseModel;
 
 /**
+ * @phpstan-import-type CacheMetadataShape from \ContextDev\AI\AIExtractProductResponse\CacheMetadata
  * @phpstan-import-type KeyMetadataShape from \ContextDev\AI\AIExtractProductResponse\KeyMetadata
  * @phpstan-import-type ProductShape from \ContextDev\AI\AIExtractProductResponse\Product
  *
  * @phpstan-type AIExtractProductResponseShape = array{
+ *   cacheMetadata: CacheMetadata|CacheMetadataShape,
  *   isProductPage?: bool|null,
  *   keyMetadata?: null|KeyMetadata|KeyMetadataShape,
  *   platform?: null|Platform|value-of<Platform>,
@@ -27,6 +31,12 @@ final class AIExtractProductResponse implements BaseModel
     /** @use SdkModel<AIExtractProductResponseShape> */
     use SdkModel;
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     */
+    #[Required('cache_metadata')]
+    public CacheMetadata $cacheMetadata;
+
     /**
      * Whether the given URL is a product detail page.
      */
@@ -53,6 +63,20 @@ final class AIExtractProductResponse implements BaseModel
     #[Optional(nullable: true)]
     public ?Product $product;
 
+    /**
+     * `new AIExtractProductResponse()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * AIExtractProductResponse::with(cacheMetadata: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new AIExtractProductResponse)->withCacheMetadata(...)
+     * ```
+     */
     public function __construct()
     {
         $this->initialize();
@@ -63,11 +87,13 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
      * @param KeyMetadata|KeyMetadataShape|null $keyMetadata
      * @param Platform|value-of<Platform>|null $platform
      * @param Product|ProductShape|null $product
      */
     public static function with(
+        CacheMetadata|array $cacheMetadata,
         ?bool $isProductPage = null,
         KeyMetadata|array|null $keyMetadata = null,
         Platform|string|null $platform = null,
@@ -75,6 +101,8 @@ public static function with(
     ): self {
         $self = new self;
 
+        $self['cacheMetadata'] = $cacheMetadata;
+
         null !== $isProductPage && $self['isProductPage'] = $isProductPage;
         null !== $keyMetadata && $self['keyMetadata'] = $keyMetadata;
         null !== $platform && $self['platform'] = $platform;
@@ -83,6 +111,19 @@ public static function with(
         return $self;
     }
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
+     */
+    public function withCacheMetadata(CacheMetadata|array $cacheMetadata): self
+    {
+        $self = clone $this;
+        $self['cacheMetadata'] = $cacheMetadata;
+
+        return $self;
+    }
+
     /**
      * Whether the given URL is a product detail page.
      */
diff --git a/src/AI/AIExtractProductResponse/CacheMetadata.php b/src/AI/AIExtractProductResponse/CacheMetadata.php
new file mode 100644
index 0000000..5ceeffa
--- /dev/null
+++ b/src/AI/AIExtractProductResponse/CacheMetadata.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\AI\AIExtractProductResponse;
+
+use ContextDev\AI\AIExtractProductResponse\CacheMetadata\Status;
+use ContextDev\Core\Attributes\Required;
+use ContextDev\Core\Concerns\SdkModel;
+use ContextDev\Core\Contracts\BaseModel;
+
+/**
+ * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+ *
+ * @phpstan-type CacheMetadataShape = array{
+ *   ageMs: int, status: Status|value-of<Status>
+ * }
+ */
+final class CacheMetadata implements BaseModel
+{
+    /** @use SdkModel<CacheMetadataShape> */
+    use SdkModel;
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    #[Required('age_ms')]
+    public int $ageMs;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @var value-of<Status> $status
+     */
+    #[Required(enum: Status::class)]
+    public string $status;
+
+    /**
+     * `new CacheMetadata()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * CacheMetadata::with(ageMs: ..., status: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new CacheMetadata)->withAgeMs(...)->withStatus(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public static function with(int $ageMs, Status|string $status): self
+    {
+        $self = new self;
+
+        $self['ageMs'] = $ageMs;
+        $self['status'] = $status;
+
+        return $self;
+    }
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    public function withAgeMs(int $ageMs): self
+    {
+        $self = clone $this;
+        $self['ageMs'] = $ageMs;
+
+        return $self;
+    }
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public function withStatus(Status|string $status): self
+    {
+        $self = clone $this;
+        $self['status'] = $status;
+
+        return $self;
+    }
+}
diff --git a/src/AI/AIExtractProductResponse/CacheMetadata/Status.php b/src/AI/AIExtractProductResponse/CacheMetadata/Status.php
new file mode 100644
index 0000000..c487aef
--- /dev/null
+++ b/src/AI/AIExtractProductResponse/CacheMetadata/Status.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\AI\AIExtractProductResponse\CacheMetadata;
+
+/**
+ * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+ */
+enum Status: string
+{
+    case HIT = 'hit';
+
+    case MISS = 'miss';
+
+    case ZDR = 'zdr';
+}
diff --git a/src/AI/AIExtractProductsResponse.php b/src/AI/AIExtractProductsResponse.php
index 708fdea..f19ed35 100644
--- a/src/AI/AIExtractProductsResponse.php
+++ b/src/AI/AIExtractProductsResponse.php
@@ -4,17 +4,21 @@
 
 namespace ContextDev\AI;
 
+use ContextDev\AI\AIExtractProductsResponse\CacheMetadata;
 use ContextDev\AI\AIExtractProductsResponse\KeyMetadata;
 use ContextDev\AI\AIExtractProductsResponse\Product;
 use ContextDev\Core\Attributes\Optional;
+use ContextDev\Core\Attributes\Required;
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Contracts\BaseModel;
 
 /**
+ * @phpstan-import-type CacheMetadataShape from \ContextDev\AI\AIExtractProductsResponse\CacheMetadata
  * @phpstan-import-type KeyMetadataShape from \ContextDev\AI\AIExtractProductsResponse\KeyMetadata
  * @phpstan-import-type ProductShape from \ContextDev\AI\AIExtractProductsResponse\Product
  *
  * @phpstan-type AIExtractProductsResponseShape = array{
+ *   cacheMetadata: CacheMetadata|CacheMetadataShape,
  *   keyMetadata?: null|KeyMetadata|KeyMetadataShape,
  *   products?: list<Product|ProductShape>|null,
  * }
@@ -24,6 +28,12 @@ final class AIExtractProductsResponse implements BaseModel
     /** @use SdkModel<AIExtractProductsResponseShape> */
     use SdkModel;
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     */
+    #[Required('cache_metadata')]
+    public CacheMetadata $cacheMetadata;
+
     /**
      * Metadata about the API key used for the request. Included in every response whenever a valid API key is provided, even when the response status is not 200.
      */
@@ -38,6 +48,20 @@ final class AIExtractProductsResponse implements BaseModel
     #[Optional(list: Product::class)]
     public ?array $products;
 
+    /**
+     * `new AIExtractProductsResponse()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * AIExtractProductsResponse::with(cacheMetadata: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new AIExtractProductsResponse)->withCacheMetadata(...)
+     * ```
+     */
     public function __construct()
     {
         $this->initialize();
@@ -48,21 +72,38 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
      * @param KeyMetadata|KeyMetadataShape|null $keyMetadata
      * @param list<Product|ProductShape>|null $products
      */
     public static function with(
+        CacheMetadata|array $cacheMetadata,
         KeyMetadata|array|null $keyMetadata = null,
-        ?array $products = null
+        ?array $products = null,
     ): self {
         $self = new self;
 
+        $self['cacheMetadata'] = $cacheMetadata;
+
         null !== $keyMetadata && $self['keyMetadata'] = $keyMetadata;
         null !== $products && $self['products'] = $products;
 
         return $self;
     }
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
+     */
+    public function withCacheMetadata(CacheMetadata|array $cacheMetadata): self
+    {
+        $self = clone $this;
+        $self['cacheMetadata'] = $cacheMetadata;
+
+        return $self;
+    }
+
     /**
      * Metadata about the API key used for the request. Included in every response whenever a valid API key is provided, even when the response status is not 200.
      *
diff --git a/src/AI/AIExtractProductsResponse/CacheMetadata.php b/src/AI/AIExtractProductsResponse/CacheMetadata.php
new file mode 100644
index 0000000..3bee8ec
--- /dev/null
+++ b/src/AI/AIExtractProductsResponse/CacheMetadata.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\AI\AIExtractProductsResponse;
+
+use ContextDev\AI\AIExtractProductsResponse\CacheMetadata\Status;
+use ContextDev\Core\Attributes\Required;
+use ContextDev\Core\Concerns\SdkModel;
+use ContextDev\Core\Contracts\BaseModel;
+
+/**
+ * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+ *
+ * @phpstan-type CacheMetadataShape = array{
+ *   ageMs: int, status: Status|value-of<Status>
+ * }
+ */
+final class CacheMetadata implements BaseModel
+{
+    /** @use SdkModel<CacheMetadataShape> */
+    use SdkModel;
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    #[Required('age_ms')]
+    public int $ageMs;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @var value-of<Status> $status
+     */
+    #[Required(enum: Status::class)]
+    public string $status;
+
+    /**
+     * `new CacheMetadata()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * CacheMetadata::with(ageMs: ..., status: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new CacheMetadata)->withAgeMs(...)->withStatus(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public static function with(int $ageMs, Status|string $status): self
+    {
+        $self = new self;
+
+        $self['ageMs'] = $ageMs;
+        $self['status'] = $status;
+
+        return $self;
+    }
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    public function withAgeMs(int $ageMs): self
+    {
+        $self = clone $this;
+        $self['ageMs'] = $ageMs;
+
+        return $self;
+    }
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public function withStatus(Status|string $status): self
+    {
+        $self = clone $this;
+        $self['status'] = $status;
+
+        return $self;
+    }
+}
diff --git a/src/AI/AIExtractProductsResponse/CacheMetadata/Status.php b/src/AI/AIExtractProductsResponse/CacheMetadata/Status.php
new file mode 100644
index 0000000..50901c3
--- /dev/null
+++ b/src/AI/AIExtractProductsResponse/CacheMetadata/Status.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\AI\AIExtractProductsResponse\CacheMetadata;
+
+/**
+ * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+ */
+enum Status: string
+{
+    case HIT = 'hit';
+
+    case MISS = 'miss';
+
+    case ZDR = 'zdr';
+}
diff --git a/src/Batch/BatchGetResultsResponse/Data/ScrapedPage.php b/src/Batch/BatchGetResultsResponse/Data/ScrapedPage.php
index c8c21cf..15f67ed 100644
--- a/src/Batch/BatchGetResultsResponse/Data/ScrapedPage.php
+++ b/src/Batch/BatchGetResultsResponse/Data/ScrapedPage.php
@@ -4,6 +4,7 @@
 
 namespace ContextDev\Batch\BatchGetResultsResponse\Data;
 
+use ContextDev\Batch\BatchGetResultsResponse\Data\ScrapedPage\CacheMetadata;
 use ContextDev\Batch\BatchGetResultsResponse\Data\ScrapedPage\Metadata;
 use ContextDev\Core\Attributes\Optional;
 use ContextDev\Core\Attributes\Required;
@@ -13,9 +14,11 @@
 /**
  * A page the batch fetched successfully.
  *
+ * @phpstan-import-type CacheMetadataShape from \ContextDev\Batch\BatchGetResultsResponse\Data\ScrapedPage\CacheMetadata
  * @phpstan-import-type MetadataShape from \ContextDev\Batch\BatchGetResultsResponse\Data\ScrapedPage\Metadata
  *
  * @phpstan-type ScrapedPageShape = array{
+ *   cacheMetadata: CacheMetadata|CacheMetadataShape,
  *   finalURL: string,
  *   httpStatus: int|null,
  *   metadata: Metadata|MetadataShape,
@@ -41,6 +44,12 @@ final class ScrapedPage implements BaseModel
     #[Required]
     public string $status = 'ok';
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     */
+    #[Required('cache_metadata')]
+    public CacheMetadata $cacheMetadata;
+
     /**
      * URL the content was read from, after redirects.
      */
@@ -102,13 +111,16 @@ final class ScrapedPage implements BaseModel
      *
      * To enforce required parameters use
      * ```
-     * ScrapedPage::with(finalURL: ..., httpStatus: ..., metadata: ..., url: ...)
+     * ScrapedPage::with(
+     *   cacheMetadata: ..., finalURL: ..., httpStatus: ..., metadata: ..., url: ...
+     * )
      * ```
      *
      * Otherwise ensure the following setters are called
      *
      * ```
      * (new ScrapedPage)
+     *   ->withCacheMetadata(...)
      *   ->withFinalURL(...)
      *   ->withHTTPStatus(...)
      *   ->withMetadata(...)
@@ -125,10 +137,12 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
      * @param Metadata|MetadataShape $metadata
      * @param array<string,mixed>|null $meta
      */
     public static function with(
+        CacheMetadata|array $cacheMetadata,
         string $finalURL,
         ?int $httpStatus,
         Metadata|array $metadata,
@@ -141,6 +155,7 @@ public static function with(
     ): self {
         $self = new self;
 
+        $self['cacheMetadata'] = $cacheMetadata;
         $self['finalURL'] = $finalURL;
         $self['httpStatus'] = $httpStatus;
         $self['metadata'] = $metadata;
@@ -155,6 +170,19 @@ public static function with(
         return $self;
     }
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
+     */
+    public function withCacheMetadata(CacheMetadata|array $cacheMetadata): self
+    {
+        $self = clone $this;
+        $self['cacheMetadata'] = $cacheMetadata;
+
+        return $self;
+    }
+
     /**
      * URL the content was read from, after redirects.
      */
diff --git a/src/Batch/BatchGetResultsResponse/Data/ScrapedPage/CacheMetadata.php b/src/Batch/BatchGetResultsResponse/Data/ScrapedPage/CacheMetadata.php
new file mode 100644
index 0000000..643a136
--- /dev/null
+++ b/src/Batch/BatchGetResultsResponse/Data/ScrapedPage/CacheMetadata.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Batch\BatchGetResultsResponse\Data\ScrapedPage;
+
+use ContextDev\Batch\BatchGetResultsResponse\Data\ScrapedPage\CacheMetadata\Status;
+use ContextDev\Core\Attributes\Required;
+use ContextDev\Core\Concerns\SdkModel;
+use ContextDev\Core\Contracts\BaseModel;
+
+/**
+ * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+ *
+ * @phpstan-type CacheMetadataShape = array{
+ *   ageMs: int, status: Status|value-of<Status>
+ * }
+ */
+final class CacheMetadata implements BaseModel
+{
+    /** @use SdkModel<CacheMetadataShape> */
+    use SdkModel;
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    #[Required('age_ms')]
+    public int $ageMs;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @var value-of<Status> $status
+     */
+    #[Required(enum: Status::class)]
+    public string $status;
+
+    /**
+     * `new CacheMetadata()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * CacheMetadata::with(ageMs: ..., status: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new CacheMetadata)->withAgeMs(...)->withStatus(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public static function with(int $ageMs, Status|string $status): self
+    {
+        $self = new self;
+
+        $self['ageMs'] = $ageMs;
+        $self['status'] = $status;
+
+        return $self;
+    }
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    public function withAgeMs(int $ageMs): self
+    {
+        $self = clone $this;
+        $self['ageMs'] = $ageMs;
+
+        return $self;
+    }
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public function withStatus(Status|string $status): self
+    {
+        $self = clone $this;
+        $self['status'] = $status;
+
+        return $self;
+    }
+}
diff --git a/src/Batch/BatchGetResultsResponse/Data/ScrapedPage/CacheMetadata/Status.php b/src/Batch/BatchGetResultsResponse/Data/ScrapedPage/CacheMetadata/Status.php
new file mode 100644
index 0000000..ae97dbe
--- /dev/null
+++ b/src/Batch/BatchGetResultsResponse/Data/ScrapedPage/CacheMetadata/Status.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Batch\BatchGetResultsResponse\Data\ScrapedPage\CacheMetadata;
+
+/**
+ * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+ */
+enum Status: string
+{
+    case HIT = 'hit';
+
+    case MISS = 'miss';
+
+    case ZDR = 'zdr';
+}
diff --git a/src/Batch/BatchSubmitResponse.php b/src/Batch/BatchSubmitResponse.php
index 0082a4a..3f331f7 100644
--- a/src/Batch/BatchSubmitResponse.php
+++ b/src/Batch/BatchSubmitResponse.php
@@ -4,6 +4,7 @@
 
 namespace ContextDev\Batch;
 
+use ContextDev\Batch\BatchSubmitResponse\CacheMetadata;
 use ContextDev\Batch\BatchSubmitResponse\Credits;
 use ContextDev\Batch\BatchSubmitResponse\Format;
 use ContextDev\Batch\BatchSubmitResponse\InvalidURL;
@@ -16,6 +17,7 @@
 use ContextDev\Core\Contracts\BaseModel;
 
 /**
+ * @phpstan-import-type CacheMetadataShape from \ContextDev\Batch\BatchSubmitResponse\CacheMetadata
  * @phpstan-import-type CrawlControlsShape from \ContextDev\Batch\CrawlControls
  * @phpstan-import-type CreditsShape from \ContextDev\Batch\BatchSubmitResponse\Credits
  * @phpstan-import-type IntakeShape from \ContextDev\Batch\Intake
@@ -24,6 +26,7 @@
  *
  * @phpstan-type BatchSubmitResponseShape = array{
  *   id: string,
+ *   cacheMetadata: CacheMetadata|CacheMetadataShape,
  *   crawl: null|CrawlControls|CrawlControlsShape,
  *   createdAt: string,
  *   credits: Credits|CreditsShape,
@@ -48,6 +51,12 @@ final class BatchSubmitResponse implements BaseModel
     #[Required]
     public string $id;
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     */
+    #[Required('cache_metadata')]
+    public CacheMetadata $cacheMetadata;
+
     /**
      * The crawl controls as submitted, so the limits requested can be compared against what the crawl reached.
      */
@@ -131,6 +140,7 @@ final class BatchSubmitResponse implements BaseModel
      * ```
      * BatchSubmitResponse::with(
      *   id: ...,
+     *   cacheMetadata: ...,
      *   crawl: ...,
      *   createdAt: ...,
      *   credits: ...,
@@ -148,6 +158,7 @@ final class BatchSubmitResponse implements BaseModel
      * ```
      * (new BatchSubmitResponse)
      *   ->withID(...)
+     *   ->withCacheMetadata(...)
      *   ->withCrawl(...)
      *   ->withCreatedAt(...)
      *   ->withCredits(...)
@@ -169,6 +180,7 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
      * @param CrawlControls|CrawlControlsShape|null $crawl
      * @param Credits|CreditsShape $credits
      * @param Format|value-of<Format> $format
@@ -181,6 +193,7 @@ public function __construct()
      */
     public static function with(
         string $id,
+        CacheMetadata|array $cacheMetadata,
         CrawlControls|array|null $crawl,
         string $createdAt,
         Credits|array $credits,
@@ -196,6 +209,7 @@ public static function with(
         $self = new self;
 
         $self['id'] = $id;
+        $self['cacheMetadata'] = $cacheMetadata;
         $self['crawl'] = $crawl;
         $self['createdAt'] = $createdAt;
         $self['credits'] = $credits;
@@ -223,6 +237,19 @@ public function withID(string $id): self
         return $self;
     }
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
+     */
+    public function withCacheMetadata(CacheMetadata|array $cacheMetadata): self
+    {
+        $self = clone $this;
+        $self['cacheMetadata'] = $cacheMetadata;
+
+        return $self;
+    }
+
     /**
      * The crawl controls as submitted, so the limits requested can be compared against what the crawl reached.
      *
diff --git a/src/Batch/BatchSubmitResponse/CacheMetadata.php b/src/Batch/BatchSubmitResponse/CacheMetadata.php
new file mode 100644
index 0000000..92da327
--- /dev/null
+++ b/src/Batch/BatchSubmitResponse/CacheMetadata.php
@@ -0,0 +1,103 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Batch\BatchSubmitResponse;
+
+use ContextDev\Batch\BatchSubmitResponse\CacheMetadata\Status;
+use ContextDev\Core\Attributes\Required;
+use ContextDev\Core\Concerns\SdkModel;
+use ContextDev\Core\Contracts\BaseModel;
+
+/**
+ * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+ *
+ * @phpstan-type CacheMetadataShape = array{
+ *   ageMs: int,
+ *   status: \ContextDev\Batch\BatchSubmitResponse\CacheMetadata\Status|value-of<\ContextDev\Batch\BatchSubmitResponse\CacheMetadata\Status>,
+ * }
+ */
+final class CacheMetadata implements BaseModel
+{
+    /** @use SdkModel<CacheMetadataShape> */
+    use SdkModel;
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    #[Required('age_ms')]
+    public int $ageMs;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @var value-of<Status> $status
+     */
+    #[Required(
+        enum: Status::class
+    )]
+    public string $status;
+
+    /**
+     * `new CacheMetadata()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * CacheMetadata::with(ageMs: ..., status: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new CacheMetadata)->withAgeMs(...)->withStatus(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public static function with(
+        int $ageMs,
+        Status|string $status,
+    ): self {
+        $self = new self;
+
+        $self['ageMs'] = $ageMs;
+        $self['status'] = $status;
+
+        return $self;
+    }
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    public function withAgeMs(int $ageMs): self
+    {
+        $self = clone $this;
+        $self['ageMs'] = $ageMs;
+
+        return $self;
+    }
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public function withStatus(
+        Status|string $status
+    ): self {
+        $self = clone $this;
+        $self['status'] = $status;
+
+        return $self;
+    }
+}
diff --git a/src/Batch/BatchSubmitResponse/CacheMetadata/Status.php b/src/Batch/BatchSubmitResponse/CacheMetadata/Status.php
new file mode 100644
index 0000000..68d3c53
--- /dev/null
+++ b/src/Batch/BatchSubmitResponse/CacheMetadata/Status.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Batch\BatchSubmitResponse\CacheMetadata;
+
+/**
+ * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+ */
+enum Status: string
+{
+    case HIT = 'hit';
+
+    case MISS = 'miss';
+
+    case ZDR = 'zdr';
+}
diff --git a/src/Brand/BrandGetResponse.php b/src/Brand/BrandGetResponse.php
index c06a63f..bb455c5 100644
--- a/src/Brand/BrandGetResponse.php
+++ b/src/Brand/BrandGetResponse.php
@@ -5,16 +5,20 @@
 namespace ContextDev\Brand;
 
 use ContextDev\Brand\BrandGetResponse\Brand;
+use ContextDev\Brand\BrandGetResponse\CacheMetadata;
 use ContextDev\Brand\BrandGetResponse\KeyMetadata;
 use ContextDev\Core\Attributes\Optional;
+use ContextDev\Core\Attributes\Required;
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Contracts\BaseModel;
 
 /**
+ * @phpstan-import-type CacheMetadataShape from \ContextDev\Brand\BrandGetResponse\CacheMetadata
  * @phpstan-import-type BrandShape from \ContextDev\Brand\BrandGetResponse\Brand
  * @phpstan-import-type KeyMetadataShape from \ContextDev\Brand\BrandGetResponse\KeyMetadata
  *
  * @phpstan-type BrandGetResponseShape = array{
+ *   cacheMetadata: CacheMetadata|CacheMetadataShape,
  *   brand?: null|Brand|BrandShape,
  *   code?: int|null,
  *   keyMetadata?: null|KeyMetadata|KeyMetadataShape,
@@ -26,6 +30,12 @@ final class BrandGetResponse implements BaseModel
     /** @use SdkModel<BrandGetResponseShape> */
     use SdkModel;
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     */
+    #[Required('cache_metadata')]
+    public CacheMetadata $cacheMetadata;
+
     /**
      * Detailed brand information.
      */
@@ -50,6 +60,20 @@ final class BrandGetResponse implements BaseModel
     #[Optional]
     public ?string $status;
 
+    /**
+     * `new BrandGetResponse()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * BrandGetResponse::with(cacheMetadata: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new BrandGetResponse)->withCacheMetadata(...)
+     * ```
+     */
     public function __construct()
     {
         $this->initialize();
@@ -60,10 +84,12 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
      * @param Brand|BrandShape|null $brand
      * @param KeyMetadata|KeyMetadataShape|null $keyMetadata
      */
     public static function with(
+        CacheMetadata|array $cacheMetadata,
         Brand|array|null $brand = null,
         ?int $code = null,
         KeyMetadata|array|null $keyMetadata = null,
@@ -71,6 +97,8 @@ public static function with(
     ): self {
         $self = new self;
 
+        $self['cacheMetadata'] = $cacheMetadata;
+
         null !== $brand && $self['brand'] = $brand;
         null !== $code && $self['code'] = $code;
         null !== $keyMetadata && $self['keyMetadata'] = $keyMetadata;
@@ -79,6 +107,19 @@ public static function with(
         return $self;
     }
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
+     */
+    public function withCacheMetadata(CacheMetadata|array $cacheMetadata): self
+    {
+        $self = clone $this;
+        $self['cacheMetadata'] = $cacheMetadata;
+
+        return $self;
+    }
+
     /**
      * Detailed brand information.
      *
diff --git a/src/Brand/BrandGetResponse/Brand.php b/src/Brand/BrandGetResponse/Brand.php
index a540ecf..6acb0b9 100644
--- a/src/Brand/BrandGetResponse/Brand.php
+++ b/src/Brand/BrandGetResponse/Brand.php
@@ -121,7 +121,7 @@ final class Brand implements BaseModel
     public ?Links $links;
 
     /**
-     * An array of logos associated with the brand.
+     * An array of logos associated with the brand. When a similarly shaped SVG variant exists, it is returned ahead of its raster equivalent; otherwise relevance order is preserved.
      *
      * @var list<Logo>|null $logos
      */
@@ -354,7 +354,7 @@ public function withLinks(Links|array $links): self
     }
 
     /**
-     * An array of logos associated with the brand.
+     * An array of logos associated with the brand. When a similarly shaped SVG variant exists, it is returned ahead of its raster equivalent; otherwise relevance order is preserved.
      *
      * @param list<Logo|LogoShape> $logos
      */
diff --git a/src/Brand/BrandGetResponse/CacheMetadata.php b/src/Brand/BrandGetResponse/CacheMetadata.php
new file mode 100644
index 0000000..b7a530a
--- /dev/null
+++ b/src/Brand/BrandGetResponse/CacheMetadata.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Brand\BrandGetResponse;
+
+use ContextDev\Brand\BrandGetResponse\CacheMetadata\Status;
+use ContextDev\Core\Attributes\Required;
+use ContextDev\Core\Concerns\SdkModel;
+use ContextDev\Core\Contracts\BaseModel;
+
+/**
+ * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+ *
+ * @phpstan-type CacheMetadataShape = array{
+ *   ageMs: int, status: Status|value-of<Status>
+ * }
+ */
+final class CacheMetadata implements BaseModel
+{
+    /** @use SdkModel<CacheMetadataShape> */
+    use SdkModel;
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    #[Required('age_ms')]
+    public int $ageMs;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @var value-of<Status> $status
+     */
+    #[Required(enum: Status::class)]
+    public string $status;
+
+    /**
+     * `new CacheMetadata()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * CacheMetadata::with(ageMs: ..., status: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new CacheMetadata)->withAgeMs(...)->withStatus(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public static function with(int $ageMs, Status|string $status): self
+    {
+        $self = new self;
+
+        $self['ageMs'] = $ageMs;
+        $self['status'] = $status;
+
+        return $self;
+    }
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    public function withAgeMs(int $ageMs): self
+    {
+        $self = clone $this;
+        $self['ageMs'] = $ageMs;
+
+        return $self;
+    }
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public function withStatus(Status|string $status): self
+    {
+        $self = clone $this;
+        $self['status'] = $status;
+
+        return $self;
+    }
+}
diff --git a/src/Brand/BrandGetResponse/CacheMetadata/Status.php b/src/Brand/BrandGetResponse/CacheMetadata/Status.php
new file mode 100644
index 0000000..e36f6c0
--- /dev/null
+++ b/src/Brand/BrandGetResponse/CacheMetadata/Status.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Brand\BrandGetResponse\CacheMetadata;
+
+/**
+ * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+ */
+enum Status: string
+{
+    case HIT = 'hit';
+
+    case MISS = 'miss';
+
+    case ZDR = 'zdr';
+}
diff --git a/src/Brand/BrandGetSimplifiedResponse.php b/src/Brand/BrandGetSimplifiedResponse.php
index b9857d1..38d305e 100644
--- a/src/Brand/BrandGetSimplifiedResponse.php
+++ b/src/Brand/BrandGetSimplifiedResponse.php
@@ -5,16 +5,20 @@
 namespace ContextDev\Brand;
 
 use ContextDev\Brand\BrandGetSimplifiedResponse\Brand;
+use ContextDev\Brand\BrandGetSimplifiedResponse\CacheMetadata;
 use ContextDev\Brand\BrandGetSimplifiedResponse\KeyMetadata;
 use ContextDev\Core\Attributes\Optional;
+use ContextDev\Core\Attributes\Required;
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Contracts\BaseModel;
 
 /**
+ * @phpstan-import-type CacheMetadataShape from \ContextDev\Brand\BrandGetSimplifiedResponse\CacheMetadata
  * @phpstan-import-type BrandShape from \ContextDev\Brand\BrandGetSimplifiedResponse\Brand
  * @phpstan-import-type KeyMetadataShape from \ContextDev\Brand\BrandGetSimplifiedResponse\KeyMetadata
  *
  * @phpstan-type BrandGetSimplifiedResponseShape = array{
+ *   cacheMetadata: CacheMetadata|CacheMetadataShape,
  *   brand?: null|Brand|BrandShape,
  *   code?: int|null,
  *   keyMetadata?: null|KeyMetadata|KeyMetadataShape,
@@ -26,6 +30,12 @@ final class BrandGetSimplifiedResponse implements BaseModel
     /** @use SdkModel<BrandGetSimplifiedResponseShape> */
     use SdkModel;
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     */
+    #[Required('cache_metadata')]
+    public CacheMetadata $cacheMetadata;
+
     /**
      * Simplified brand information.
      */
@@ -50,6 +60,20 @@ final class BrandGetSimplifiedResponse implements BaseModel
     #[Optional]
     public ?string $status;
 
+    /**
+     * `new BrandGetSimplifiedResponse()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * BrandGetSimplifiedResponse::with(cacheMetadata: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new BrandGetSimplifiedResponse)->withCacheMetadata(...)
+     * ```
+     */
     public function __construct()
     {
         $this->initialize();
@@ -60,10 +84,12 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
      * @param Brand|BrandShape|null $brand
      * @param KeyMetadata|KeyMetadataShape|null $keyMetadata
      */
     public static function with(
+        CacheMetadata|array $cacheMetadata,
         Brand|array|null $brand = null,
         ?int $code = null,
         KeyMetadata|array|null $keyMetadata = null,
@@ -71,6 +97,8 @@ public static function with(
     ): self {
         $self = new self;
 
+        $self['cacheMetadata'] = $cacheMetadata;
+
         null !== $brand && $self['brand'] = $brand;
         null !== $code && $self['code'] = $code;
         null !== $keyMetadata && $self['keyMetadata'] = $keyMetadata;
@@ -79,6 +107,19 @@ public static function with(
         return $self;
     }
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
+     */
+    public function withCacheMetadata(CacheMetadata|array $cacheMetadata): self
+    {
+        $self = clone $this;
+        $self['cacheMetadata'] = $cacheMetadata;
+
+        return $self;
+    }
+
     /**
      * Simplified brand information.
      *
diff --git a/src/Brand/BrandGetSimplifiedResponse/CacheMetadata.php b/src/Brand/BrandGetSimplifiedResponse/CacheMetadata.php
new file mode 100644
index 0000000..28b3b3c
--- /dev/null
+++ b/src/Brand/BrandGetSimplifiedResponse/CacheMetadata.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Brand\BrandGetSimplifiedResponse;
+
+use ContextDev\Brand\BrandGetSimplifiedResponse\CacheMetadata\Status;
+use ContextDev\Core\Attributes\Required;
+use ContextDev\Core\Concerns\SdkModel;
+use ContextDev\Core\Contracts\BaseModel;
+
+/**
+ * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+ *
+ * @phpstan-type CacheMetadataShape = array{
+ *   ageMs: int, status: Status|value-of<Status>
+ * }
+ */
+final class CacheMetadata implements BaseModel
+{
+    /** @use SdkModel<CacheMetadataShape> */
+    use SdkModel;
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    #[Required('age_ms')]
+    public int $ageMs;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @var value-of<Status> $status
+     */
+    #[Required(enum: Status::class)]
+    public string $status;
+
+    /**
+     * `new CacheMetadata()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * CacheMetadata::with(ageMs: ..., status: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new CacheMetadata)->withAgeMs(...)->withStatus(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public static function with(int $ageMs, Status|string $status): self
+    {
+        $self = new self;
+
+        $self['ageMs'] = $ageMs;
+        $self['status'] = $status;
+
+        return $self;
+    }
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    public function withAgeMs(int $ageMs): self
+    {
+        $self = clone $this;
+        $self['ageMs'] = $ageMs;
+
+        return $self;
+    }
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public function withStatus(Status|string $status): self
+    {
+        $self = clone $this;
+        $self['status'] = $status;
+
+        return $self;
+    }
+}
diff --git a/src/Brand/BrandGetSimplifiedResponse/CacheMetadata/Status.php b/src/Brand/BrandGetSimplifiedResponse/CacheMetadata/Status.php
new file mode 100644
index 0000000..83d0d10
--- /dev/null
+++ b/src/Brand/BrandGetSimplifiedResponse/CacheMetadata/Status.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Brand\BrandGetSimplifiedResponse\CacheMetadata;
+
+/**
+ * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+ */
+enum Status: string
+{
+    case HIT = 'hit';
+
+    case MISS = 'miss';
+
+    case ZDR = 'zdr';
+}
diff --git a/src/Version.php b/src/Version.php
index 500f4fa..570ea43 100644
--- a/src/Version.php
+++ b/src/Version.php
@@ -5,5 +5,5 @@
 namespace ContextDev;
 
 // x-release-please-start-version
-const VERSION = '2.12.0';
+const VERSION = '2.13.0';
 // x-release-please-end
diff --git a/src/Web/WebExtractFontsResponse.php b/src/Web/WebExtractFontsResponse.php
index d4f3e9c..4825a8b 100644
--- a/src/Web/WebExtractFontsResponse.php
+++ b/src/Web/WebExtractFontsResponse.php
@@ -8,16 +8,19 @@
 use ContextDev\Core\Attributes\Required;
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebExtractFontsResponse\CacheMetadata;
 use ContextDev\Web\WebExtractFontsResponse\Font;
 use ContextDev\Web\WebExtractFontsResponse\FontLink;
 use ContextDev\Web\WebExtractFontsResponse\KeyMetadata;
 
 /**
+ * @phpstan-import-type CacheMetadataShape from \ContextDev\Web\WebExtractFontsResponse\CacheMetadata
  * @phpstan-import-type FontShape from \ContextDev\Web\WebExtractFontsResponse\Font
  * @phpstan-import-type FontLinkShape from \ContextDev\Web\WebExtractFontsResponse\FontLink
  * @phpstan-import-type KeyMetadataShape from \ContextDev\Web\WebExtractFontsResponse\KeyMetadata
  *
  * @phpstan-type WebExtractFontsResponseShape = array{
+ *   cacheMetadata: CacheMetadata|CacheMetadataShape,
  *   code: int,
  *   domain: string,
  *   fonts: list<Font|FontShape>,
@@ -31,6 +34,12 @@ final class WebExtractFontsResponse implements BaseModel
     /** @use SdkModel<WebExtractFontsResponseShape> */
     use SdkModel;
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     */
+    #[Required('cache_metadata')]
+    public CacheMetadata $cacheMetadata;
+
     /**
      * HTTP status code, e.g., 200.
      */
@@ -76,13 +85,16 @@ final class WebExtractFontsResponse implements BaseModel
      *
      * To enforce required parameters use
      * ```
-     * WebExtractFontsResponse::with(code: ..., domain: ..., fonts: ..., status: ...)
+     * WebExtractFontsResponse::with(
+     *   cacheMetadata: ..., code: ..., domain: ..., fonts: ..., status: ...
+     * )
      * ```
      *
      * Otherwise ensure the following setters are called
      *
      * ```
      * (new WebExtractFontsResponse)
+     *   ->withCacheMetadata(...)
      *   ->withCode(...)
      *   ->withDomain(...)
      *   ->withFonts(...)
@@ -99,11 +111,13 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
      * @param list<Font|FontShape> $fonts
      * @param array<string,FontLink|FontLinkShape>|null $fontLinks
      * @param KeyMetadata|KeyMetadataShape|null $keyMetadata
      */
     public static function with(
+        CacheMetadata|array $cacheMetadata,
         int $code,
         string $domain,
         array $fonts,
@@ -113,6 +127,7 @@ public static function with(
     ): self {
         $self = new self;
 
+        $self['cacheMetadata'] = $cacheMetadata;
         $self['code'] = $code;
         $self['domain'] = $domain;
         $self['fonts'] = $fonts;
@@ -124,6 +139,19 @@ public static function with(
         return $self;
     }
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
+     */
+    public function withCacheMetadata(CacheMetadata|array $cacheMetadata): self
+    {
+        $self = clone $this;
+        $self['cacheMetadata'] = $cacheMetadata;
+
+        return $self;
+    }
+
     /**
      * HTTP status code, e.g., 200.
      */
diff --git a/src/Web/WebExtractFontsResponse/CacheMetadata.php b/src/Web/WebExtractFontsResponse/CacheMetadata.php
new file mode 100644
index 0000000..9fdceac
--- /dev/null
+++ b/src/Web/WebExtractFontsResponse/CacheMetadata.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebExtractFontsResponse;
+
+use ContextDev\Core\Attributes\Required;
+use ContextDev\Core\Concerns\SdkModel;
+use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebExtractFontsResponse\CacheMetadata\Status;
+
+/**
+ * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+ *
+ * @phpstan-type CacheMetadataShape = array{
+ *   ageMs: int, status: Status|value-of<Status>
+ * }
+ */
+final class CacheMetadata implements BaseModel
+{
+    /** @use SdkModel<CacheMetadataShape> */
+    use SdkModel;
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    #[Required('age_ms')]
+    public int $ageMs;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @var value-of<Status> $status
+     */
+    #[Required(enum: Status::class)]
+    public string $status;
+
+    /**
+     * `new CacheMetadata()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * CacheMetadata::with(ageMs: ..., status: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new CacheMetadata)->withAgeMs(...)->withStatus(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public static function with(int $ageMs, Status|string $status): self
+    {
+        $self = new self;
+
+        $self['ageMs'] = $ageMs;
+        $self['status'] = $status;
+
+        return $self;
+    }
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    public function withAgeMs(int $ageMs): self
+    {
+        $self = clone $this;
+        $self['ageMs'] = $ageMs;
+
+        return $self;
+    }
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public function withStatus(Status|string $status): self
+    {
+        $self = clone $this;
+        $self['status'] = $status;
+
+        return $self;
+    }
+}
diff --git a/src/Web/WebExtractFontsResponse/CacheMetadata/Status.php b/src/Web/WebExtractFontsResponse/CacheMetadata/Status.php
new file mode 100644
index 0000000..da36777
--- /dev/null
+++ b/src/Web/WebExtractFontsResponse/CacheMetadata/Status.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebExtractFontsResponse\CacheMetadata;
+
+/**
+ * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+ */
+enum Status: string
+{
+    case HIT = 'hit';
+
+    case MISS = 'miss';
+
+    case ZDR = 'zdr';
+}
diff --git a/src/Web/WebExtractResponse.php b/src/Web/WebExtractResponse.php
index 3b44bdd..77e2540 100644
--- a/src/Web/WebExtractResponse.php
+++ b/src/Web/WebExtractResponse.php
@@ -8,14 +8,17 @@
 use ContextDev\Core\Attributes\Required;
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebExtractResponse\CacheMetadata;
 use ContextDev\Web\WebExtractResponse\KeyMetadata;
 use ContextDev\Web\WebExtractResponse\Metadata;
 
 /**
+ * @phpstan-import-type CacheMetadataShape from \ContextDev\Web\WebExtractResponse\CacheMetadata
  * @phpstan-import-type MetadataShape from \ContextDev\Web\WebExtractResponse\Metadata
  * @phpstan-import-type KeyMetadataShape from \ContextDev\Web\WebExtractResponse\KeyMetadata
  *
  * @phpstan-type WebExtractResponseShape = array{
+ *   cacheMetadata: CacheMetadata|CacheMetadataShape,
  *   data: array<string,mixed>,
  *   metadata: Metadata|MetadataShape,
  *   status: string,
@@ -29,6 +32,12 @@ final class WebExtractResponse implements BaseModel
     /** @use SdkModel<WebExtractResponseShape> */
     use SdkModel;
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     */
+    #[Required('cache_metadata')]
+    public CacheMetadata $cacheMetadata;
+
     /**
      * Extracted data matching the request schema.
      *
@@ -72,7 +81,12 @@ final class WebExtractResponse implements BaseModel
      * To enforce required parameters use
      * ```
      * WebExtractResponse::with(
-     *   data: ..., metadata: ..., status: ..., url: ..., urlsAnalyzed: ...
+     *   cacheMetadata: ...,
+     *   data: ...,
+     *   metadata: ...,
+     *   status: ...,
+     *   url: ...,
+     *   urlsAnalyzed: ...,
      * )
      * ```
      *
@@ -80,6 +94,7 @@ final class WebExtractResponse implements BaseModel
      *
      * ```
      * (new WebExtractResponse)
+     *   ->withCacheMetadata(...)
      *   ->withData(...)
      *   ->withMetadata(...)
      *   ->withStatus(...)
@@ -97,12 +112,14 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
      * @param array<string,mixed> $data
      * @param Metadata|MetadataShape $metadata
      * @param list<string> $urlsAnalyzed
      * @param KeyMetadata|KeyMetadataShape|null $keyMetadata
      */
     public static function with(
+        CacheMetadata|array $cacheMetadata,
         array $data,
         Metadata|array $metadata,
         string $status,
@@ -112,6 +129,7 @@ public static function with(
     ): self {
         $self = new self;
 
+        $self['cacheMetadata'] = $cacheMetadata;
         $self['data'] = $data;
         $self['metadata'] = $metadata;
         $self['status'] = $status;
@@ -123,6 +141,19 @@ public static function with(
         return $self;
     }
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
+     */
+    public function withCacheMetadata(CacheMetadata|array $cacheMetadata): self
+    {
+        $self = clone $this;
+        $self['cacheMetadata'] = $cacheMetadata;
+
+        return $self;
+    }
+
     /**
      * Extracted data matching the request schema.
      *
diff --git a/src/Web/WebExtractResponse/CacheMetadata.php b/src/Web/WebExtractResponse/CacheMetadata.php
new file mode 100644
index 0000000..f176b3f
--- /dev/null
+++ b/src/Web/WebExtractResponse/CacheMetadata.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebExtractResponse;
+
+use ContextDev\Core\Attributes\Required;
+use ContextDev\Core\Concerns\SdkModel;
+use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebExtractResponse\CacheMetadata\Status;
+
+/**
+ * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+ *
+ * @phpstan-type CacheMetadataShape = array{
+ *   ageMs: int, status: Status|value-of<Status>
+ * }
+ */
+final class CacheMetadata implements BaseModel
+{
+    /** @use SdkModel<CacheMetadataShape> */
+    use SdkModel;
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    #[Required('age_ms')]
+    public int $ageMs;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @var value-of<Status> $status
+     */
+    #[Required(enum: Status::class)]
+    public string $status;
+
+    /**
+     * `new CacheMetadata()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * CacheMetadata::with(ageMs: ..., status: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new CacheMetadata)->withAgeMs(...)->withStatus(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public static function with(int $ageMs, Status|string $status): self
+    {
+        $self = new self;
+
+        $self['ageMs'] = $ageMs;
+        $self['status'] = $status;
+
+        return $self;
+    }
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    public function withAgeMs(int $ageMs): self
+    {
+        $self = clone $this;
+        $self['ageMs'] = $ageMs;
+
+        return $self;
+    }
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public function withStatus(Status|string $status): self
+    {
+        $self = clone $this;
+        $self['status'] = $status;
+
+        return $self;
+    }
+}
diff --git a/src/Web/WebExtractResponse/CacheMetadata/Status.php b/src/Web/WebExtractResponse/CacheMetadata/Status.php
new file mode 100644
index 0000000..3e0c37c
--- /dev/null
+++ b/src/Web/WebExtractResponse/CacheMetadata/Status.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebExtractResponse\CacheMetadata;
+
+/**
+ * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+ */
+enum Status: string
+{
+    case HIT = 'hit';
+
+    case MISS = 'miss';
+
+    case ZDR = 'zdr';
+}
diff --git a/src/Web/WebExtractStyleguideResponse.php b/src/Web/WebExtractStyleguideResponse.php
index dc622db..6474536 100644
--- a/src/Web/WebExtractStyleguideResponse.php
+++ b/src/Web/WebExtractStyleguideResponse.php
@@ -5,16 +5,20 @@
 namespace ContextDev\Web;
 
 use ContextDev\Core\Attributes\Optional;
+use ContextDev\Core\Attributes\Required;
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebExtractStyleguideResponse\CacheMetadata;
 use ContextDev\Web\WebExtractStyleguideResponse\KeyMetadata;
 use ContextDev\Web\WebExtractStyleguideResponse\Styleguide;
 
 /**
+ * @phpstan-import-type CacheMetadataShape from \ContextDev\Web\WebExtractStyleguideResponse\CacheMetadata
  * @phpstan-import-type KeyMetadataShape from \ContextDev\Web\WebExtractStyleguideResponse\KeyMetadata
  * @phpstan-import-type StyleguideShape from \ContextDev\Web\WebExtractStyleguideResponse\Styleguide
  *
  * @phpstan-type WebExtractStyleguideResponseShape = array{
+ *   cacheMetadata: CacheMetadata|CacheMetadataShape,
  *   code?: int|null,
  *   domain?: string|null,
  *   keyMetadata?: null|KeyMetadata|KeyMetadataShape,
@@ -27,6 +31,12 @@ final class WebExtractStyleguideResponse implements BaseModel
     /** @use SdkModel<WebExtractStyleguideResponseShape> */
     use SdkModel;
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     */
+    #[Required('cache_metadata')]
+    public CacheMetadata $cacheMetadata;
+
     /**
      * HTTP status code.
      */
@@ -57,6 +67,20 @@ final class WebExtractStyleguideResponse implements BaseModel
     #[Optional]
     public ?Styleguide $styleguide;
 
+    /**
+     * `new WebExtractStyleguideResponse()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * WebExtractStyleguideResponse::with(cacheMetadata: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new WebExtractStyleguideResponse)->withCacheMetadata(...)
+     * ```
+     */
     public function __construct()
     {
         $this->initialize();
@@ -67,10 +91,12 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
      * @param KeyMetadata|KeyMetadataShape|null $keyMetadata
      * @param Styleguide|StyleguideShape|null $styleguide
      */
     public static function with(
+        CacheMetadata|array $cacheMetadata,
         ?int $code = null,
         ?string $domain = null,
         KeyMetadata|array|null $keyMetadata = null,
@@ -79,6 +105,8 @@ public static function with(
     ): self {
         $self = new self;
 
+        $self['cacheMetadata'] = $cacheMetadata;
+
         null !== $code && $self['code'] = $code;
         null !== $domain && $self['domain'] = $domain;
         null !== $keyMetadata && $self['keyMetadata'] = $keyMetadata;
@@ -88,6 +116,19 @@ public static function with(
         return $self;
     }
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
+     */
+    public function withCacheMetadata(CacheMetadata|array $cacheMetadata): self
+    {
+        $self = clone $this;
+        $self['cacheMetadata'] = $cacheMetadata;
+
+        return $self;
+    }
+
     /**
      * HTTP status code.
      */
diff --git a/src/Web/WebExtractStyleguideResponse/CacheMetadata.php b/src/Web/WebExtractStyleguideResponse/CacheMetadata.php
new file mode 100644
index 0000000..7b8ef61
--- /dev/null
+++ b/src/Web/WebExtractStyleguideResponse/CacheMetadata.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebExtractStyleguideResponse;
+
+use ContextDev\Core\Attributes\Required;
+use ContextDev\Core\Concerns\SdkModel;
+use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebExtractStyleguideResponse\CacheMetadata\Status;
+
+/**
+ * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+ *
+ * @phpstan-type CacheMetadataShape = array{
+ *   ageMs: int, status: Status|value-of<Status>
+ * }
+ */
+final class CacheMetadata implements BaseModel
+{
+    /** @use SdkModel<CacheMetadataShape> */
+    use SdkModel;
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    #[Required('age_ms')]
+    public int $ageMs;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @var value-of<Status> $status
+     */
+    #[Required(enum: Status::class)]
+    public string $status;
+
+    /**
+     * `new CacheMetadata()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * CacheMetadata::with(ageMs: ..., status: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new CacheMetadata)->withAgeMs(...)->withStatus(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public static function with(int $ageMs, Status|string $status): self
+    {
+        $self = new self;
+
+        $self['ageMs'] = $ageMs;
+        $self['status'] = $status;
+
+        return $self;
+    }
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    public function withAgeMs(int $ageMs): self
+    {
+        $self = clone $this;
+        $self['ageMs'] = $ageMs;
+
+        return $self;
+    }
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public function withStatus(Status|string $status): self
+    {
+        $self = clone $this;
+        $self['status'] = $status;
+
+        return $self;
+    }
+}
diff --git a/src/Web/WebExtractStyleguideResponse/CacheMetadata/Status.php b/src/Web/WebExtractStyleguideResponse/CacheMetadata/Status.php
new file mode 100644
index 0000000..f37c97d
--- /dev/null
+++ b/src/Web/WebExtractStyleguideResponse/CacheMetadata/Status.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebExtractStyleguideResponse\CacheMetadata;
+
+/**
+ * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+ */
+enum Status: string
+{
+    case HIT = 'hit';
+
+    case MISS = 'miss';
+
+    case ZDR = 'zdr';
+}
diff --git a/src/Web/WebScreenshotResponse.php b/src/Web/WebScreenshotResponse.php
index 546eea1..655385d 100644
--- a/src/Web/WebScreenshotResponse.php
+++ b/src/Web/WebScreenshotResponse.php
@@ -5,15 +5,19 @@
 namespace ContextDev\Web;
 
 use ContextDev\Core\Attributes\Optional;
+use ContextDev\Core\Attributes\Required;
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebScreenshotResponse\CacheMetadata;
 use ContextDev\Web\WebScreenshotResponse\KeyMetadata;
 use ContextDev\Web\WebScreenshotResponse\ScreenshotType;
 
 /**
+ * @phpstan-import-type CacheMetadataShape from \ContextDev\Web\WebScreenshotResponse\CacheMetadata
  * @phpstan-import-type KeyMetadataShape from \ContextDev\Web\WebScreenshotResponse\KeyMetadata
  *
  * @phpstan-type WebScreenshotResponseShape = array{
+ *   cacheMetadata: CacheMetadata|CacheMetadataShape,
  *   code?: int|null,
  *   domain?: string|null,
  *   height?: int|null,
@@ -29,6 +33,12 @@ final class WebScreenshotResponse implements BaseModel
     /** @use SdkModel<WebScreenshotResponseShape> */
     use SdkModel;
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     */
+    #[Required('cache_metadata')]
+    public CacheMetadata $cacheMetadata;
+
     /**
      * HTTP status code.
      */
@@ -79,6 +89,20 @@ final class WebScreenshotResponse implements BaseModel
     #[Optional]
     public ?int $width;
 
+    /**
+     * `new WebScreenshotResponse()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * WebScreenshotResponse::with(cacheMetadata: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new WebScreenshotResponse)->withCacheMetadata(...)
+     * ```
+     */
     public function __construct()
     {
         $this->initialize();
@@ -89,10 +113,12 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
      * @param KeyMetadata|KeyMetadataShape|null $keyMetadata
      * @param ScreenshotType|value-of<ScreenshotType>|null $screenshotType
      */
     public static function with(
+        CacheMetadata|array $cacheMetadata,
         ?int $code = null,
         ?string $domain = null,
         ?int $height = null,
@@ -104,6 +130,8 @@ public static function with(
     ): self {
         $self = new self;
 
+        $self['cacheMetadata'] = $cacheMetadata;
+
         null !== $code && $self['code'] = $code;
         null !== $domain && $self['domain'] = $domain;
         null !== $height && $self['height'] = $height;
@@ -116,6 +144,19 @@ public static function with(
         return $self;
     }
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
+     */
+    public function withCacheMetadata(CacheMetadata|array $cacheMetadata): self
+    {
+        $self = clone $this;
+        $self['cacheMetadata'] = $cacheMetadata;
+
+        return $self;
+    }
+
     /**
      * HTTP status code.
      */
diff --git a/src/Web/WebScreenshotResponse/CacheMetadata.php b/src/Web/WebScreenshotResponse/CacheMetadata.php
new file mode 100644
index 0000000..77d24e6
--- /dev/null
+++ b/src/Web/WebScreenshotResponse/CacheMetadata.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebScreenshotResponse;
+
+use ContextDev\Core\Attributes\Required;
+use ContextDev\Core\Concerns\SdkModel;
+use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebScreenshotResponse\CacheMetadata\Status;
+
+/**
+ * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+ *
+ * @phpstan-type CacheMetadataShape = array{
+ *   ageMs: int, status: Status|value-of<Status>
+ * }
+ */
+final class CacheMetadata implements BaseModel
+{
+    /** @use SdkModel<CacheMetadataShape> */
+    use SdkModel;
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    #[Required('age_ms')]
+    public int $ageMs;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @var value-of<Status> $status
+     */
+    #[Required(enum: Status::class)]
+    public string $status;
+
+    /**
+     * `new CacheMetadata()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * CacheMetadata::with(ageMs: ..., status: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new CacheMetadata)->withAgeMs(...)->withStatus(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public static function with(int $ageMs, Status|string $status): self
+    {
+        $self = new self;
+
+        $self['ageMs'] = $ageMs;
+        $self['status'] = $status;
+
+        return $self;
+    }
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    public function withAgeMs(int $ageMs): self
+    {
+        $self = clone $this;
+        $self['ageMs'] = $ageMs;
+
+        return $self;
+    }
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public function withStatus(Status|string $status): self
+    {
+        $self = clone $this;
+        $self['status'] = $status;
+
+        return $self;
+    }
+}
diff --git a/src/Web/WebScreenshotResponse/CacheMetadata/Status.php b/src/Web/WebScreenshotResponse/CacheMetadata/Status.php
new file mode 100644
index 0000000..943957e
--- /dev/null
+++ b/src/Web/WebScreenshotResponse/CacheMetadata/Status.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebScreenshotResponse\CacheMetadata;
+
+/**
+ * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+ */
+enum Status: string
+{
+    case HIT = 'hit';
+
+    case MISS = 'miss';
+
+    case ZDR = 'zdr';
+}
diff --git a/src/Web/WebSearchResponse.php b/src/Web/WebSearchResponse.php
index 47db362..516c6b9 100644
--- a/src/Web/WebSearchResponse.php
+++ b/src/Web/WebSearchResponse.php
@@ -8,14 +8,17 @@
 use ContextDev\Core\Attributes\Required;
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebSearchResponse\CacheMetadata;
 use ContextDev\Web\WebSearchResponse\KeyMetadata;
 use ContextDev\Web\WebSearchResponse\Result;
 
 /**
+ * @phpstan-import-type CacheMetadataShape from \ContextDev\Web\WebSearchResponse\CacheMetadata
  * @phpstan-import-type ResultShape from \ContextDev\Web\WebSearchResponse\Result
  * @phpstan-import-type KeyMetadataShape from \ContextDev\Web\WebSearchResponse\KeyMetadata
  *
  * @phpstan-type WebSearchResponseShape = array{
+ *   cacheMetadata: CacheMetadata|CacheMetadataShape,
  *   query: string,
  *   results: list<Result|ResultShape>,
  *   keyMetadata?: null|KeyMetadata|KeyMetadataShape,
@@ -26,6 +29,12 @@ final class WebSearchResponse implements BaseModel
     /** @use SdkModel<WebSearchResponseShape> */
     use SdkModel;
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     */
+    #[Required('cache_metadata')]
+    public CacheMetadata $cacheMetadata;
+
     /**
      * Echo of the original query (useful when fanout was enabled).
      */
@@ -47,13 +56,16 @@ final class WebSearchResponse implements BaseModel
      *
      * To enforce required parameters use
      * ```
-     * WebSearchResponse::with(query: ..., results: ...)
+     * WebSearchResponse::with(cacheMetadata: ..., query: ..., results: ...)
      * ```
      *
      * Otherwise ensure the following setters are called
      *
      * ```
-     * (new WebSearchResponse)->withQuery(...)->withResults(...)
+     * (new WebSearchResponse)
+     *   ->withCacheMetadata(...)
+     *   ->withQuery(...)
+     *   ->withResults(...)
      * ```
      */
     public function __construct()
@@ -66,16 +78,19 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
      * @param list<Result|ResultShape> $results
      * @param KeyMetadata|KeyMetadataShape|null $keyMetadata
      */
     public static function with(
+        CacheMetadata|array $cacheMetadata,
         string $query,
         array $results,
-        KeyMetadata|array|null $keyMetadata = null
+        KeyMetadata|array|null $keyMetadata = null,
     ): self {
         $self = new self;
 
+        $self['cacheMetadata'] = $cacheMetadata;
         $self['query'] = $query;
         $self['results'] = $results;
 
@@ -84,6 +99,19 @@ public static function with(
         return $self;
     }
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
+     */
+    public function withCacheMetadata(CacheMetadata|array $cacheMetadata): self
+    {
+        $self = clone $this;
+        $self['cacheMetadata'] = $cacheMetadata;
+
+        return $self;
+    }
+
     /**
      * Echo of the original query (useful when fanout was enabled).
      */
diff --git a/src/Web/WebSearchResponse/CacheMetadata.php b/src/Web/WebSearchResponse/CacheMetadata.php
new file mode 100644
index 0000000..3641688
--- /dev/null
+++ b/src/Web/WebSearchResponse/CacheMetadata.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebSearchResponse;
+
+use ContextDev\Core\Attributes\Required;
+use ContextDev\Core\Concerns\SdkModel;
+use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebSearchResponse\CacheMetadata\Status;
+
+/**
+ * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+ *
+ * @phpstan-type CacheMetadataShape = array{
+ *   ageMs: int, status: Status|value-of<Status>
+ * }
+ */
+final class CacheMetadata implements BaseModel
+{
+    /** @use SdkModel<CacheMetadataShape> */
+    use SdkModel;
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    #[Required('age_ms')]
+    public int $ageMs;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @var value-of<Status> $status
+     */
+    #[Required(enum: Status::class)]
+    public string $status;
+
+    /**
+     * `new CacheMetadata()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * CacheMetadata::with(ageMs: ..., status: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new CacheMetadata)->withAgeMs(...)->withStatus(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public static function with(int $ageMs, Status|string $status): self
+    {
+        $self = new self;
+
+        $self['ageMs'] = $ageMs;
+        $self['status'] = $status;
+
+        return $self;
+    }
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    public function withAgeMs(int $ageMs): self
+    {
+        $self = clone $this;
+        $self['ageMs'] = $ageMs;
+
+        return $self;
+    }
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public function withStatus(Status|string $status): self
+    {
+        $self = clone $this;
+        $self['status'] = $status;
+
+        return $self;
+    }
+}
diff --git a/src/Web/WebSearchResponse/CacheMetadata/Status.php b/src/Web/WebSearchResponse/CacheMetadata/Status.php
new file mode 100644
index 0000000..5461240
--- /dev/null
+++ b/src/Web/WebSearchResponse/CacheMetadata/Status.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebSearchResponse\CacheMetadata;
+
+/**
+ * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+ */
+enum Status: string
+{
+    case HIT = 'hit';
+
+    case MISS = 'miss';
+
+    case ZDR = 'zdr';
+}
diff --git a/src/Web/WebWebCrawlMdResponse.php b/src/Web/WebWebCrawlMdResponse.php
index 920f873..00f77c5 100644
--- a/src/Web/WebWebCrawlMdResponse.php
+++ b/src/Web/WebWebCrawlMdResponse.php
@@ -8,16 +8,19 @@
 use ContextDev\Core\Attributes\Required;
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebWebCrawlMdResponse\CacheMetadata;
 use ContextDev\Web\WebWebCrawlMdResponse\KeyMetadata;
 use ContextDev\Web\WebWebCrawlMdResponse\Metadata;
 use ContextDev\Web\WebWebCrawlMdResponse\Result;
 
 /**
+ * @phpstan-import-type CacheMetadataShape from \ContextDev\Web\WebWebCrawlMdResponse\CacheMetadata
  * @phpstan-import-type MetadataShape from \ContextDev\Web\WebWebCrawlMdResponse\Metadata
  * @phpstan-import-type ResultShape from \ContextDev\Web\WebWebCrawlMdResponse\Result
  * @phpstan-import-type KeyMetadataShape from \ContextDev\Web\WebWebCrawlMdResponse\KeyMetadata
  *
  * @phpstan-type WebWebCrawlMdResponseShape = array{
+ *   cacheMetadata: CacheMetadata|CacheMetadataShape,
  *   metadata: Metadata|MetadataShape,
  *   results: list<Result|ResultShape>,
  *   keyMetadata?: null|KeyMetadata|KeyMetadataShape,
@@ -28,6 +31,12 @@ final class WebWebCrawlMdResponse implements BaseModel
     /** @use SdkModel<WebWebCrawlMdResponseShape> */
     use SdkModel;
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     */
+    #[Required('cache_metadata')]
+    public CacheMetadata $cacheMetadata;
+
     #[Required]
     public Metadata $metadata;
 
@@ -46,13 +55,16 @@ final class WebWebCrawlMdResponse implements BaseModel
      *
      * To enforce required parameters use
      * ```
-     * WebWebCrawlMdResponse::with(metadata: ..., results: ...)
+     * WebWebCrawlMdResponse::with(cacheMetadata: ..., metadata: ..., results: ...)
      * ```
      *
      * Otherwise ensure the following setters are called
      *
      * ```
-     * (new WebWebCrawlMdResponse)->withMetadata(...)->withResults(...)
+     * (new WebWebCrawlMdResponse)
+     *   ->withCacheMetadata(...)
+     *   ->withMetadata(...)
+     *   ->withResults(...)
      * ```
      */
     public function __construct()
@@ -65,17 +77,20 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
      * @param Metadata|MetadataShape $metadata
      * @param list<Result|ResultShape> $results
      * @param KeyMetadata|KeyMetadataShape|null $keyMetadata
      */
     public static function with(
+        CacheMetadata|array $cacheMetadata,
         Metadata|array $metadata,
         array $results,
         KeyMetadata|array|null $keyMetadata = null,
     ): self {
         $self = new self;
 
+        $self['cacheMetadata'] = $cacheMetadata;
         $self['metadata'] = $metadata;
         $self['results'] = $results;
 
@@ -84,6 +99,19 @@ public static function with(
         return $self;
     }
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
+     */
+    public function withCacheMetadata(CacheMetadata|array $cacheMetadata): self
+    {
+        $self = clone $this;
+        $self['cacheMetadata'] = $cacheMetadata;
+
+        return $self;
+    }
+
     /**
      * @param Metadata|MetadataShape $metadata
      */
diff --git a/src/Web/WebWebCrawlMdResponse/CacheMetadata.php b/src/Web/WebWebCrawlMdResponse/CacheMetadata.php
new file mode 100644
index 0000000..232a6fa
--- /dev/null
+++ b/src/Web/WebWebCrawlMdResponse/CacheMetadata.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebWebCrawlMdResponse;
+
+use ContextDev\Core\Attributes\Required;
+use ContextDev\Core\Concerns\SdkModel;
+use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebWebCrawlMdResponse\CacheMetadata\Status;
+
+/**
+ * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+ *
+ * @phpstan-type CacheMetadataShape = array{
+ *   ageMs: int, status: Status|value-of<Status>
+ * }
+ */
+final class CacheMetadata implements BaseModel
+{
+    /** @use SdkModel<CacheMetadataShape> */
+    use SdkModel;
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    #[Required('age_ms')]
+    public int $ageMs;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @var value-of<Status> $status
+     */
+    #[Required(enum: Status::class)]
+    public string $status;
+
+    /**
+     * `new CacheMetadata()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * CacheMetadata::with(ageMs: ..., status: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new CacheMetadata)->withAgeMs(...)->withStatus(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public static function with(int $ageMs, Status|string $status): self
+    {
+        $self = new self;
+
+        $self['ageMs'] = $ageMs;
+        $self['status'] = $status;
+
+        return $self;
+    }
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    public function withAgeMs(int $ageMs): self
+    {
+        $self = clone $this;
+        $self['ageMs'] = $ageMs;
+
+        return $self;
+    }
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public function withStatus(Status|string $status): self
+    {
+        $self = clone $this;
+        $self['status'] = $status;
+
+        return $self;
+    }
+}
diff --git a/src/Web/WebWebCrawlMdResponse/CacheMetadata/Status.php b/src/Web/WebWebCrawlMdResponse/CacheMetadata/Status.php
new file mode 100644
index 0000000..599211b
--- /dev/null
+++ b/src/Web/WebWebCrawlMdResponse/CacheMetadata/Status.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebWebCrawlMdResponse\CacheMetadata;
+
+/**
+ * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+ */
+enum Status: string
+{
+    case HIT = 'hit';
+
+    case MISS = 'miss';
+
+    case ZDR = 'zdr';
+}
diff --git a/src/Web/WebWebScrapeHTMLResponse.php b/src/Web/WebWebScrapeHTMLResponse.php
index a1b31a6..0e3e92a 100644
--- a/src/Web/WebWebScrapeHTMLResponse.php
+++ b/src/Web/WebWebScrapeHTMLResponse.php
@@ -9,16 +9,19 @@
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Contracts\BaseModel;
 use ContextDev\Web\WebWebScrapeHTMLResponse\ActionsApplied;
+use ContextDev\Web\WebWebScrapeHTMLResponse\CacheMetadata;
 use ContextDev\Web\WebWebScrapeHTMLResponse\KeyMetadata;
 use ContextDev\Web\WebWebScrapeHTMLResponse\Metadata;
 use ContextDev\Web\WebWebScrapeHTMLResponse\Type;
 
 /**
+ * @phpstan-import-type CacheMetadataShape from \ContextDev\Web\WebWebScrapeHTMLResponse\CacheMetadata
  * @phpstan-import-type MetadataShape from \ContextDev\Web\WebWebScrapeHTMLResponse\Metadata
  * @phpstan-import-type ActionsAppliedShape from \ContextDev\Web\WebWebScrapeHTMLResponse\ActionsApplied
  * @phpstan-import-type KeyMetadataShape from \ContextDev\Web\WebWebScrapeHTMLResponse\KeyMetadata
  *
  * @phpstan-type WebWebScrapeHTMLResponseShape = array{
+ *   cacheMetadata: CacheMetadata|CacheMetadataShape,
  *   html: string,
  *   metadata: Metadata|MetadataShape,
  *   success: bool,
@@ -34,6 +37,12 @@ final class WebWebScrapeHTMLResponse implements BaseModel
     /** @use SdkModel<WebWebScrapeHTMLResponseShape> */
     use SdkModel;
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     */
+    #[Required('cache_metadata')]
+    public CacheMetadata $cacheMetadata;
+
     /**
      * The scraped content of the page. For normal pages this is the raw HTML. When the page is a sitemap or feed served behind an XSL stylesheet (which browsers render into HTML), this is the underlying XML instead — see the `type` field.
      */
@@ -92,7 +101,12 @@ final class WebWebScrapeHTMLResponse implements BaseModel
      * To enforce required parameters use
      * ```
      * WebWebScrapeHTMLResponse::with(
-     *   html: ..., metadata: ..., success: ..., type: ..., url: ...
+     *   cacheMetadata: ...,
+     *   html: ...,
+     *   metadata: ...,
+     *   success: ...,
+     *   type: ...,
+     *   url: ...,
      * )
      * ```
      *
@@ -100,6 +114,7 @@ final class WebWebScrapeHTMLResponse implements BaseModel
      *
      * ```
      * (new WebWebScrapeHTMLResponse)
+     *   ->withCacheMetadata(...)
      *   ->withHTML(...)
      *   ->withMetadata(...)
      *   ->withSuccess(...)
@@ -117,12 +132,14 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
      * @param Metadata|MetadataShape $metadata
      * @param Type|value-of<Type> $type
      * @param list<ActionsApplied|ActionsAppliedShape>|null $actionsApplied
      * @param KeyMetadata|KeyMetadataShape|null $keyMetadata
      */
     public static function with(
+        CacheMetadata|array $cacheMetadata,
         string $html,
         Metadata|array $metadata,
         bool $success,
@@ -134,6 +151,7 @@ public static function with(
     ): self {
         $self = new self;
 
+        $self['cacheMetadata'] = $cacheMetadata;
         $self['html'] = $html;
         $self['metadata'] = $metadata;
         $self['success'] = $success;
@@ -147,6 +165,19 @@ public static function with(
         return $self;
     }
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
+     */
+    public function withCacheMetadata(CacheMetadata|array $cacheMetadata): self
+    {
+        $self = clone $this;
+        $self['cacheMetadata'] = $cacheMetadata;
+
+        return $self;
+    }
+
     /**
      * The scraped content of the page. For normal pages this is the raw HTML. When the page is a sitemap or feed served behind an XSL stylesheet (which browsers render into HTML), this is the underlying XML instead — see the `type` field.
      */
diff --git a/src/Web/WebWebScrapeHTMLResponse/CacheMetadata.php b/src/Web/WebWebScrapeHTMLResponse/CacheMetadata.php
new file mode 100644
index 0000000..e38e194
--- /dev/null
+++ b/src/Web/WebWebScrapeHTMLResponse/CacheMetadata.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebWebScrapeHTMLResponse;
+
+use ContextDev\Core\Attributes\Required;
+use ContextDev\Core\Concerns\SdkModel;
+use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebWebScrapeHTMLResponse\CacheMetadata\Status;
+
+/**
+ * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+ *
+ * @phpstan-type CacheMetadataShape = array{
+ *   ageMs: int, status: Status|value-of<Status>
+ * }
+ */
+final class CacheMetadata implements BaseModel
+{
+    /** @use SdkModel<CacheMetadataShape> */
+    use SdkModel;
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    #[Required('age_ms')]
+    public int $ageMs;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @var value-of<Status> $status
+     */
+    #[Required(enum: Status::class)]
+    public string $status;
+
+    /**
+     * `new CacheMetadata()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * CacheMetadata::with(ageMs: ..., status: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new CacheMetadata)->withAgeMs(...)->withStatus(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public static function with(int $ageMs, Status|string $status): self
+    {
+        $self = new self;
+
+        $self['ageMs'] = $ageMs;
+        $self['status'] = $status;
+
+        return $self;
+    }
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    public function withAgeMs(int $ageMs): self
+    {
+        $self = clone $this;
+        $self['ageMs'] = $ageMs;
+
+        return $self;
+    }
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public function withStatus(Status|string $status): self
+    {
+        $self = clone $this;
+        $self['status'] = $status;
+
+        return $self;
+    }
+}
diff --git a/src/Web/WebWebScrapeHTMLResponse/CacheMetadata/Status.php b/src/Web/WebWebScrapeHTMLResponse/CacheMetadata/Status.php
new file mode 100644
index 0000000..bdfe8f9
--- /dev/null
+++ b/src/Web/WebWebScrapeHTMLResponse/CacheMetadata/Status.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebWebScrapeHTMLResponse\CacheMetadata;
+
+/**
+ * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+ */
+enum Status: string
+{
+    case HIT = 'hit';
+
+    case MISS = 'miss';
+
+    case ZDR = 'zdr';
+}
diff --git a/src/Web/WebWebScrapeImagesResponse.php b/src/Web/WebWebScrapeImagesResponse.php
index a473abd..655c3a1 100644
--- a/src/Web/WebWebScrapeImagesResponse.php
+++ b/src/Web/WebWebScrapeImagesResponse.php
@@ -9,15 +9,18 @@
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Contracts\BaseModel;
 use ContextDev\Web\WebWebScrapeImagesResponse\ActionsApplied;
+use ContextDev\Web\WebWebScrapeImagesResponse\CacheMetadata;
 use ContextDev\Web\WebWebScrapeImagesResponse\Image;
 use ContextDev\Web\WebWebScrapeImagesResponse\KeyMetadata;
 
 /**
+ * @phpstan-import-type CacheMetadataShape from \ContextDev\Web\WebWebScrapeImagesResponse\CacheMetadata
  * @phpstan-import-type ImageShape from \ContextDev\Web\WebWebScrapeImagesResponse\Image
  * @phpstan-import-type ActionsAppliedShape from \ContextDev\Web\WebWebScrapeImagesResponse\ActionsApplied
  * @phpstan-import-type KeyMetadataShape from \ContextDev\Web\WebWebScrapeImagesResponse\KeyMetadata
  *
  * @phpstan-type WebWebScrapeImagesResponseShape = array{
+ *   cacheMetadata: CacheMetadata|CacheMetadataShape,
  *   images: list<Image|ImageShape>,
  *   success: bool,
  *   url: string,
@@ -30,6 +33,12 @@ final class WebWebScrapeImagesResponse implements BaseModel
     /** @use SdkModel<WebWebScrapeImagesResponseShape> */
     use SdkModel;
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     */
+    #[Required('cache_metadata')]
+    public CacheMetadata $cacheMetadata;
+
     /**
      * Images found on the page.
      *
@@ -69,13 +78,16 @@ final class WebWebScrapeImagesResponse implements BaseModel
      *
      * To enforce required parameters use
      * ```
-     * WebWebScrapeImagesResponse::with(images: ..., success: ..., url: ...)
+     * WebWebScrapeImagesResponse::with(
+     *   cacheMetadata: ..., images: ..., success: ..., url: ...
+     * )
      * ```
      *
      * Otherwise ensure the following setters are called
      *
      * ```
      * (new WebWebScrapeImagesResponse)
+     *   ->withCacheMetadata(...)
      *   ->withImages(...)
      *   ->withSuccess(...)
      *   ->withURL(...)
@@ -91,11 +103,13 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
      * @param list<Image|ImageShape> $images
      * @param list<ActionsApplied|ActionsAppliedShape>|null $actionsApplied
      * @param KeyMetadata|KeyMetadataShape|null $keyMetadata
      */
     public static function with(
+        CacheMetadata|array $cacheMetadata,
         array $images,
         bool $success,
         string $url,
@@ -104,6 +118,7 @@ public static function with(
     ): self {
         $self = new self;
 
+        $self['cacheMetadata'] = $cacheMetadata;
         $self['images'] = $images;
         $self['success'] = $success;
         $self['url'] = $url;
@@ -114,6 +129,19 @@ public static function with(
         return $self;
     }
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
+     */
+    public function withCacheMetadata(CacheMetadata|array $cacheMetadata): self
+    {
+        $self = clone $this;
+        $self['cacheMetadata'] = $cacheMetadata;
+
+        return $self;
+    }
+
     /**
      * Images found on the page.
      *
diff --git a/src/Web/WebWebScrapeImagesResponse/CacheMetadata.php b/src/Web/WebWebScrapeImagesResponse/CacheMetadata.php
new file mode 100644
index 0000000..5f5c039
--- /dev/null
+++ b/src/Web/WebWebScrapeImagesResponse/CacheMetadata.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebWebScrapeImagesResponse;
+
+use ContextDev\Core\Attributes\Required;
+use ContextDev\Core\Concerns\SdkModel;
+use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebWebScrapeImagesResponse\CacheMetadata\Status;
+
+/**
+ * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+ *
+ * @phpstan-type CacheMetadataShape = array{
+ *   ageMs: int, status: Status|value-of<Status>
+ * }
+ */
+final class CacheMetadata implements BaseModel
+{
+    /** @use SdkModel<CacheMetadataShape> */
+    use SdkModel;
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    #[Required('age_ms')]
+    public int $ageMs;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @var value-of<Status> $status
+     */
+    #[Required(enum: Status::class)]
+    public string $status;
+
+    /**
+     * `new CacheMetadata()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * CacheMetadata::with(ageMs: ..., status: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new CacheMetadata)->withAgeMs(...)->withStatus(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public static function with(int $ageMs, Status|string $status): self
+    {
+        $self = new self;
+
+        $self['ageMs'] = $ageMs;
+        $self['status'] = $status;
+
+        return $self;
+    }
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    public function withAgeMs(int $ageMs): self
+    {
+        $self = clone $this;
+        $self['ageMs'] = $ageMs;
+
+        return $self;
+    }
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public function withStatus(Status|string $status): self
+    {
+        $self = clone $this;
+        $self['status'] = $status;
+
+        return $self;
+    }
+}
diff --git a/src/Web/WebWebScrapeImagesResponse/CacheMetadata/Status.php b/src/Web/WebWebScrapeImagesResponse/CacheMetadata/Status.php
new file mode 100644
index 0000000..5eeff11
--- /dev/null
+++ b/src/Web/WebWebScrapeImagesResponse/CacheMetadata/Status.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebWebScrapeImagesResponse\CacheMetadata;
+
+/**
+ * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+ */
+enum Status: string
+{
+    case HIT = 'hit';
+
+    case MISS = 'miss';
+
+    case ZDR = 'zdr';
+}
diff --git a/src/Web/WebWebScrapeMdResponse.php b/src/Web/WebWebScrapeMdResponse.php
index 0a96690..93f7445 100644
--- a/src/Web/WebWebScrapeMdResponse.php
+++ b/src/Web/WebWebScrapeMdResponse.php
@@ -9,15 +9,18 @@
 use ContextDev\Core\Concerns\SdkModel;
 use ContextDev\Core\Contracts\BaseModel;
 use ContextDev\Web\WebWebScrapeMdResponse\ActionsApplied;
+use ContextDev\Web\WebWebScrapeMdResponse\CacheMetadata;
 use ContextDev\Web\WebWebScrapeMdResponse\KeyMetadata;
 use ContextDev\Web\WebWebScrapeMdResponse\Metadata;
 
 /**
+ * @phpstan-import-type CacheMetadataShape from \ContextDev\Web\WebWebScrapeMdResponse\CacheMetadata
  * @phpstan-import-type MetadataShape from \ContextDev\Web\WebWebScrapeMdResponse\Metadata
  * @phpstan-import-type ActionsAppliedShape from \ContextDev\Web\WebWebScrapeMdResponse\ActionsApplied
  * @phpstan-import-type KeyMetadataShape from \ContextDev\Web\WebWebScrapeMdResponse\KeyMetadata
  *
  * @phpstan-type WebWebScrapeMdResponseShape = array{
+ *   cacheMetadata: CacheMetadata|CacheMetadataShape,
  *   contentLength: int,
  *   markdown: string,
  *   metadata: Metadata|MetadataShape,
@@ -34,6 +37,12 @@ final class WebWebScrapeMdResponse implements BaseModel
     /** @use SdkModel<WebWebScrapeMdResponseShape> */
     use SdkModel;
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     */
+    #[Required('cache_metadata')]
+    public CacheMetadata $cacheMetadata;
+
     /**
      * UTF-8 byte length of the returned Markdown. Use 0 to identify an empty result and compare small values against your workload's minimum useful-content threshold.
      */
@@ -96,7 +105,12 @@ final class WebWebScrapeMdResponse implements BaseModel
      * To enforce required parameters use
      * ```
      * WebWebScrapeMdResponse::with(
-     *   contentLength: ..., markdown: ..., metadata: ..., success: ..., url: ...
+     *   cacheMetadata: ...,
+     *   contentLength: ...,
+     *   markdown: ...,
+     *   metadata: ...,
+     *   success: ...,
+     *   url: ...,
      * )
      * ```
      *
@@ -104,6 +118,7 @@ final class WebWebScrapeMdResponse implements BaseModel
      *
      * ```
      * (new WebWebScrapeMdResponse)
+     *   ->withCacheMetadata(...)
      *   ->withContentLength(...)
      *   ->withMarkdown(...)
      *   ->withMetadata(...)
@@ -121,11 +136,13 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
      * @param Metadata|MetadataShape $metadata
      * @param list<ActionsApplied|ActionsAppliedShape>|null $actionsApplied
      * @param KeyMetadata|KeyMetadataShape|null $keyMetadata
      */
     public static function with(
+        CacheMetadata|array $cacheMetadata,
         int $contentLength,
         string $markdown,
         Metadata|array $metadata,
@@ -138,6 +155,7 @@ public static function with(
     ): self {
         $self = new self;
 
+        $self['cacheMetadata'] = $cacheMetadata;
         $self['contentLength'] = $contentLength;
         $self['markdown'] = $markdown;
         $self['metadata'] = $metadata;
@@ -152,6 +170,19 @@ public static function with(
         return $self;
     }
 
+    /**
+     * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+     *
+     * @param CacheMetadata|CacheMetadataShape $cacheMetadata
+     */
+    public function withCacheMetadata(CacheMetadata|array $cacheMetadata): self
+    {
+        $self = clone $this;
+        $self['cacheMetadata'] = $cacheMetadata;
+
+        return $self;
+    }
+
     /**
      * UTF-8 byte length of the returned Markdown. Use 0 to identify an empty result and compare small values against your workload's minimum useful-content threshold.
      */
diff --git a/src/Web/WebWebScrapeMdResponse/CacheMetadata.php b/src/Web/WebWebScrapeMdResponse/CacheMetadata.php
new file mode 100644
index 0000000..1798491
--- /dev/null
+++ b/src/Web/WebWebScrapeMdResponse/CacheMetadata.php
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebWebScrapeMdResponse;
+
+use ContextDev\Core\Attributes\Required;
+use ContextDev\Core\Concerns\SdkModel;
+use ContextDev\Core\Contracts\BaseModel;
+use ContextDev\Web\WebWebScrapeMdResponse\CacheMetadata\Status;
+
+/**
+ * Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
+ *
+ * @phpstan-type CacheMetadataShape = array{
+ *   ageMs: int, status: Status|value-of<Status>
+ * }
+ */
+final class CacheMetadata implements BaseModel
+{
+    /** @use SdkModel<CacheMetadataShape> */
+    use SdkModel;
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    #[Required('age_ms')]
+    public int $ageMs;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @var value-of<Status> $status
+     */
+    #[Required(enum: Status::class)]
+    public string $status;
+
+    /**
+     * `new CacheMetadata()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * CacheMetadata::with(ageMs: ..., status: ...)
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new CacheMetadata)->withAgeMs(...)->withStatus(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public static function with(int $ageMs, Status|string $status): self
+    {
+        $self = new self;
+
+        $self['ageMs'] = $ageMs;
+        $self['status'] = $status;
+
+        return $self;
+    }
+
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    public function withAgeMs(int $ageMs): self
+    {
+        $self = clone $this;
+        $self['ageMs'] = $ageMs;
+
+        return $self;
+    }
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+     *
+     * @param Status|value-of<Status> $status
+     */
+    public function withStatus(Status|string $status): self
+    {
+        $self = clone $this;
+        $self['status'] = $status;
+
+        return $self;
+    }
+}
diff --git a/src/Web/WebWebScrapeMdResponse/CacheMetadata/Status.php b/src/Web/WebWebScrapeMdResponse/CacheMetadata/Status.php
new file mode 100644
index 0000000..412bd26
--- /dev/null
+++ b/src/Web/WebWebScrapeMdResponse/CacheMetadata/Status.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ContextDev\Web\WebWebScrapeMdResponse\CacheMetadata;
+
+/**
+ * Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
+ */
+enum Status: string
+{
+    case HIT = 'hit';
+
+    case MISS = 'miss';
+
+    case ZDR = 'zdr';
+}