release: 2.14.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "2.13.0"
+  ".": "2.14.0"
 }

.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

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 2.14.0 (2026-08-27)
+
+Full Changelog: [v2.13.0...v2.14.0](https://github.com/context-dot-dev/context-typescript-sdk/compare/v2.13.0...v2.14.0)
+
+### Features
+
+* **api:** api update ([2bac956](https://github.com/context-dot-dev/context-typescript-sdk/commit/2bac9560e6409ddddc31648fc8c6e8a1f3ac0da3))
+* **api:** api update ([5809c3c](https://github.com/context-dot-dev/context-typescript-sdk/commit/5809c3c4842f3e4e2a32fe5c3992bf5eb45a0d8e))
+
 ## 2.13.0 (2026-08-23)
 
 Full Changelog: [v2.12.0...v2.13.0](https://github.com/context-dot-dev/context-typescript-sdk/compare/v2.12.0...v2.13.0)

README.md

@@ -37,7 +37,7 @@ const client = new ContextDev({
 
 const brand = await client.brand.retrieve({ domain: 'REPLACE_ME', type: 'by_domain' });
 
-console.log(brand.brand);
+console.log(brand.cache_metadata);
 ```
 
 ### Request & Response types
@@ -158,7 +158,7 @@ const { data: brand, response: raw } = await client.brand
   .retrieve({ domain: 'REPLACE_ME', type: 'by_domain' })
   .withResponse();
 console.log(raw.headers.get('X-My-Header'));
-console.log(brand.brand);
+console.log(brand.cache_metadata);
 ```
 
 ### Logging

package.json

@@ -1,6 +1,6 @@
 {
   "name": "context.dev",
-  "version": "2.13.0",
+  "version": "2.14.0",
   "description": "The official TypeScript library for the Context Dev API",
   "author": "Context Dev <hello@context.dev>",
   "types": "dist/index.d.ts",

packages/mcp-server/manifest.json

@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.2",
   "name": "context.dev-mcp",
-  "version": "2.13.0",
+  "version": "2.14.0",
   "description": "The official MCP Server for the Context Dev API",
   "author": {
     "name": "Context Dev",

packages/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context.dev-mcp",
-  "version": "2.13.0",
+  "version": "2.14.0",
   "description": "The official MCP Server for the Context Dev API",
   "author": "Context Dev <hello@context.dev>",
   "types": "dist/index.d.ts",

packages/mcp-server/src/code-tool.ts

@@ -27,7 +27,7 @@ For example:
 async function run(client) {
   const brand = await client.brand.retrieve({ domain: 'REPLACE_ME', type: 'by_domain' });
 
-  console.log(brand.brand);
+  console.log(brand.cache_metadata);
 }
 \`\`\`
 

packages/mcp-server/src/server.ts

@@ -28,7 +28,7 @@ export const newMcpServer = async ({
   new McpServer(
     {
       name: 'context_dev_api',
-      version: '2.13.0',
+      version: '2.14.0',
     },
     {
       instructions: await getInstructions({ stainlessApiKey, customInstructionsPath }),

src/resources/ai.ts

@@ -44,6 +44,13 @@ export class AI extends APIResource {
 }
 
 export interface AIExtractProductResponse {
+  /**
+   * 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.
+   */
+  cache_metadata: AIExtractProductResponse.CacheMetadata;
+
   /**
    * Whether the given URL is a product detail page
    */
@@ -67,6 +74,24 @@ export interface AIExtractProductResponse {
 }
 
 export namespace AIExtractProductResponse {
+  /**
+   * 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.
+   */
+  export interface CacheMetadata {
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    age_ms: number;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored
+     * zero-data-retention cache bypass.
+     */
+    status: 'hit' | 'miss' | 'zdr';
+  }
+
   /**
    * 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.
@@ -183,6 +208,13 @@ export namespace AIExtractProductResponse {
 }
 
 export interface AIExtractProductsResponse {
+  /**
+   * 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.
+   */
+  cache_metadata: AIExtractProductsResponse.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.
@@ -196,6 +228,24 @@ export interface AIExtractProductsResponse {
 }
 
 export namespace AIExtractProductsResponse {
+  /**
+   * 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.
+   */
+  export interface CacheMetadata {
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    age_ms: number;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored
+     * zero-data-retention cache bypass.
+     */
+    status: 'hit' | 'miss' | 'zdr';
+  }
+
   /**
    * 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.

src/resources/batch.ts

@@ -871,6 +871,13 @@ export namespace BatchGetResultsResponse {
    * A page the batch fetched successfully.
    */
   export interface 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.
+     */
+    cache_metadata: Ok.CacheMetadata;
+
     /**
      * URL the content was read from, after redirects.
      */
@@ -925,6 +932,24 @@ export namespace BatchGetResultsResponse {
   }
 
   export namespace 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.
+     */
+    export interface CacheMetadata {
+      /**
+       * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+       */
+      age_ms: number;
+
+      /**
+       * Whether the response was served from cache, required fresh work, or honored
+       * zero-data-retention cache bypass.
+       */
+      status: 'hit' | 'miss' | 'zdr';
+    }
+
     /**
      * Metadata extracted from the scraped page HTML.
      */
@@ -1127,6 +1152,13 @@ export interface BatchSubmitResponse {
    */
   id: string;
 
+  /**
+   * 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.
+   */
+  cache_metadata: BatchSubmitResponse.CacheMetadata;
+
   /**
    * The crawl controls as submitted, so the limits requested can be compared against
    * what the crawl reached.
@@ -1186,6 +1218,24 @@ export interface BatchSubmitResponse {
 }
 
 export namespace BatchSubmitResponse {
+  /**
+   * 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.
+   */
+  export interface CacheMetadata {
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    age_ms: number;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored
+     * zero-data-retention cache bypass.
+     */
+    status: 'hit' | 'miss' | 'zdr';
+  }
+
   /**
    * What accepting this batch cost.
    */

src/resources/brand.ts

@@ -57,6 +57,13 @@ export class Brand extends APIResource {
 }
 
 export interface BrandRetrieveResponse {
+  /**
+   * 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.
+   */
+  cache_metadata: BrandRetrieveResponse.CacheMetadata;
+
   /**
    * Detailed brand information
    */
@@ -80,6 +87,24 @@ export interface BrandRetrieveResponse {
 }
 
 export namespace BrandRetrieveResponse {
+  /**
+   * 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.
+   */
+  export interface CacheMetadata {
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    age_ms: number;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored
+     * zero-data-retention cache bypass.
+     */
+    status: 'hit' | 'miss' | 'zdr';
+  }
+
   /**
    * Detailed brand information
    */
@@ -135,7 +160,9 @@ export namespace BrandRetrieveResponse {
     links?: Brand.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
      */
     logos?: Array<Brand.Logo>;
 
@@ -870,6 +897,13 @@ export namespace BrandRetrieveResponse {
 }
 
 export interface BrandRetrieveSimplifiedResponse {
+  /**
+   * 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.
+   */
+  cache_metadata: BrandRetrieveSimplifiedResponse.CacheMetadata;
+
   /**
    * Simplified brand information
    */
@@ -893,6 +927,24 @@ export interface BrandRetrieveSimplifiedResponse {
 }
 
 export namespace BrandRetrieveSimplifiedResponse {
+  /**
+   * 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.
+   */
+  export interface CacheMetadata {
+    /**
+     * Age of the cached data in milliseconds. Zero for miss and zdr responses.
+     */
+    age_ms: number;
+
+    /**
+     * Whether the response was served from cache, required fresh work, or honored
+     * zero-data-retention cache bypass.
+     */
+    status: 'hit' | 'miss' | 'zdr';
+  }
+
   /**
    * Simplified brand information
    */