release: 0.10.0 (#59)

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.9.0"
+  ".": "0.10.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 34
+configured_endpoints: 36
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/contextual-ai%2Fsunrise-c8152db455001be3f09a3bc60d63711699d2c2a4ea5f7bbc1d71726efda0fd9b.yml
 openapi_spec_hash: 97719df292ca220de5d35d36f9756b95
-config_hash: ae81af9b7eb88a788a80bcf3480e0b6b
+config_hash: fdaf751580ba8a60e222e560847af1ac

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.10.0 (2025-11-11)
+
+Full Changelog: [v0.9.0...v0.10.0](https://github.com/ContextualAI/contextual-client-node/compare/v0.9.0...v0.10.0)
+
+### Features
+
+* **api:** update via SDK Studio ([314253f](https://github.com/ContextualAI/contextual-client-node/commit/314253f03cbf07ecc2f6a0f4e856d4d0000f544e))
+
 ## 0.9.0 (2025-10-28)
 
 Full Changelog: [v0.8.0...v0.9.0](https://github.com/ContextualAI/contextual-client-node/compare/v0.8.0...v0.9.0)

api.md

@@ -40,6 +40,18 @@ Methods:
 - <code title="get /datastores/{datastore_id}/documents/{document_id}/metadata">client.datastores.documents.<a href="./src/resources/datastores/documents.ts">metadata</a>(datastoreId, documentId) -> DocumentMetadata</code>
 - <code title="put /datastores/{datastore_id}/documents/{document_id}/metadata">client.datastores.documents.<a href="./src/resources/datastores/documents.ts">setMetadata</a>(datastoreId, documentId, { ...params }) -> DocumentMetadata</code>
 
+## Contents
+
+Types:
+
+- <code><a href="./src/resources/datastores/contents.ts">ContentListResponse</a></code>
+- <code><a href="./src/resources/datastores/contents.ts">ContentMetadataResponse</a></code>
+
+Methods:
+
+- <code title="get /datastores/{datastore_id}/contents">client.datastores.contents.<a href="./src/resources/datastores/contents.ts">list</a>(datastoreId, { ...params }) -> ContentListResponsesContentsPage</code>
+- <code title="get /datastores/{datastore_id}/contents/{content_id}/metadata">client.datastores.contents.<a href="./src/resources/datastores/contents.ts">metadata</a>(datastoreId, contentId, { ...params }) -> ContentMetadataResponse</code>
+
 # Agents
 
 Types:

package.json

@@ -1,6 +1,6 @@
 {
   "name": "contextual-client",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "The official TypeScript library for the Contextual AI API",
   "author": "Contextual AI <[email protected]>",
   "types": "dist/index.d.ts",

src/index.ts

@@ -6,6 +6,8 @@ import * as Core from './core';
 import * as Errors from './error';
 import * as Pagination from './pagination';
 import {
+  type ContentsPageParams,
+  ContentsPageResponse,
   type DatastoresPageParams,
   DatastoresPageResponse,
   type DocumentsPageParams,
@@ -281,6 +283,9 @@ export declare namespace ContextualAI {
   export import Page = Pagination.Page;
   export { type PageParams as PageParams, type PageResponse as PageResponse };
 
+  export import ContentsPage = Pagination.ContentsPage;
+  export { type ContentsPageParams as ContentsPageParams, type ContentsPageResponse as ContentsPageResponse };
+
   export {
     Datastores as Datastores,
     type CreateDatastoreResponse as CreateDatastoreResponse,

src/pagination.ts

@@ -224,3 +224,50 @@ export class Page<Item> extends AbstractPage<Item> implements PageResponse<Item>
     };
   }
 }
+
+export interface ContentsPageResponse<Item> {
+  data: Array<Item>;
+}
+
+export interface ContentsPageParams {
+  limit?: number;
+
+  offset?: number;
+}
+
+export class ContentsPage<Item> extends AbstractPage<Item> implements ContentsPageResponse<Item> {
+  data: Array<Item>;
+
+  constructor(
+    client: APIClient,
+    response: Response,
+    body: ContentsPageResponse<Item>,
+    options: FinalRequestOptions,
+  ) {
+    super(client, response, body, options);
+
+    this.data = body.data || [];
+  }
+
+  getPaginatedItems(): Item[] {
+    return this.data ?? [];
+  }
+
+  // @deprecated Please use `nextPageInfo()` instead
+  nextPageParams(): Partial<ContentsPageParams> | null {
+    const info = this.nextPageInfo();
+    if (!info) return null;
+    if ('params' in info) return info.params;
+    const params = Object.fromEntries(info.url.searchParams);
+    if (!Object.keys(params).length) return null;
+    return params;
+  }
+
+  nextPageInfo(): PageInfo | null {
+    const offset = (this.options.query as ContentsPageParams).offset ?? 0;
+    const length = this.getPaginatedItems().length;
+    const currentCount = offset + length;
+
+    return { params: { offset: currentCount } };
+  }
+}

src/resources/datastores/contents.ts

@@ -0,0 +1,240 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../resource';
+import { isRequestOptions } from '../../core';
+import * as Core from '../../core';
+import { ContentsPage, type ContentsPageParams } from '../../pagination';
+
+export class Contents extends APIResource {
+  /**
+   * Get Document Contents
+   */
+  list(
+    datastoreId: string,
+    query?: ContentListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<ContentListResponsesContentsPage, ContentListResponse>;
+  list(
+    datastoreId: string,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<ContentListResponsesContentsPage, ContentListResponse>;
+  list(
+    datastoreId: string,
+    query: ContentListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<ContentListResponsesContentsPage, ContentListResponse> {
+    if (isRequestOptions(query)) {
+      return this.list(datastoreId, {}, query);
+    }
+    return this._client.getAPIList(`/datastores/${datastoreId}/contents`, ContentListResponsesContentsPage, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Get Content Metadata
+   */
+  metadata(
+    datastoreId: string,
+    contentId: string,
+    query?: ContentMetadataParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ContentMetadataResponse>;
+  metadata(
+    datastoreId: string,
+    contentId: string,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ContentMetadataResponse>;
+  metadata(
+    datastoreId: string,
+    contentId: string,
+    query: ContentMetadataParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ContentMetadataResponse> {
+    if (isRequestOptions(query)) {
+      return this.metadata(datastoreId, contentId, {}, query);
+    }
+    return this._client.get(`/datastores/${datastoreId}/contents/${contentId}/metadata`, {
+      query,
+      ...options,
+    });
+  }
+}
+
+export class ContentListResponsesContentsPage extends ContentsPage<ContentListResponse> {}
+
+/**
+ * Content entry type
+ */
+export type ContentListResponse =
+  | ContentListResponse.DocumentContentEntry
+  | ContentListResponse.StructuredContentEntry;
+
+export namespace ContentListResponse {
+  export interface DocumentContentEntry {
+    /**
+     * ID of the content
+     */
+    content_id: string;
+
+    /**
+     * Page number of the content
+     */
+    page_number: number;
+
+    content_type?: 'unstructured';
+  }
+
+  /**
+   * Tabular content entry used in query retrieval.
+   */
+  export interface StructuredContentEntry {
+    /**
+     * ID of the content
+     */
+    content_id: string;
+
+    /**
+     * Name of the table
+     */
+    table_name: string;
+
+    content_type?: 'structured';
+
+    /**
+     * Name of the schema of the table
+     */
+    schema?: string | null;
+  }
+}
+
+/**
+ * Content type
+ */
+export type ContentMetadataResponse =
+  | ContentMetadataResponse.UnstructuredContentMetadata
+  | ContentMetadataResponse.StructuredContentMetadata
+  | ContentMetadataResponse.FileAnalysisContentMetadata;
+
+export namespace ContentMetadataResponse {
+  export interface UnstructuredContentMetadata {
+    /**
+     * Id of the content.
+     */
+    content_id: string;
+
+    /**
+     * Text of the content.
+     */
+    content_text: string;
+
+    /**
+     * Id of the document which the content belongs to.
+     */
+    document_id: string;
+
+    /**
+     * Height of the image.
+     */
+    height: number;
+
+    /**
+     * Page number of the content.
+     */
+    page: number;
+
+    /**
+     * Image of the page on which the content occurs.
+     */
+    page_img: string;
+
+    /**
+     * Width of the image.
+     */
+    width: number;
+
+    /**
+     * X coordinate of the top left corner on the bounding box.
+     */
+    x0: number;
+
+    /**
+     * X coordinate of the bottom right corner on the bounding box.
+     */
+    x1: number;
+
+    /**
+     * Y coordinate of the top left corner on the bounding box.
+     */
+    y0: number;
+
+    /**
+     * Y coordinate of the bottom right corner on the bounding box.
+     */
+    y1: number;
+
+    content_type?: 'unstructured';
+  }
+
+  export interface StructuredContentMetadata {
+    /**
+     * Id of the content.
+     */
+    content_id: string;
+
+    /**
+     * Text of the content.
+     */
+    content_text: unknown;
+
+    content_type?: 'structured';
+  }
+
+  export interface FileAnalysisContentMetadata {
+    /**
+     * Id of the content.
+     */
+    content_id: string;
+
+    /**
+     * Format of the file.
+     */
+    file_format: string;
+
+    /**
+     * GCP location of the file.
+     */
+    gcp_location: string;
+
+    content_type?: 'file_analysis';
+  }
+}
+
+export interface ContentListParams extends ContentsPageParams {
+  /**
+   * Document ID of the document to retrieve details for
+   */
+  document_id?: string;
+
+  /**
+   * The query to search keywords for
+   */
+  search?: string;
+}
+
+export interface ContentMetadataParams {
+  cursor?: string;
+}
+
+Contents.ContentListResponsesContentsPage = ContentListResponsesContentsPage;
+
+export declare namespace Contents {
+  export {
+    type ContentListResponse as ContentListResponse,
+    type ContentMetadataResponse as ContentMetadataResponse,
+    ContentListResponsesContentsPage as ContentListResponsesContentsPage,
+    type ContentListParams as ContentListParams,
+    type ContentMetadataParams as ContentMetadataParams,
+  };
+}