feat: fix(api): RAG-286: Add to_markdown subresource to AI resource

* fix(api): RAG-286: Add to_markdown subresource to AI resource

Author: stainless-app[bot]

.eslintcache

@@ -1 +1 @@
-[{"/home/tempuser-ld8s1t/run/codegen-output/cloudflare/cloudflare-node/src/resources/intel/indicator-feeds/downloads.ts":"1","/home/tempuser-ld8s1t/run/codegen-output/cloudflare/cloudflare-node/src/resources/intel/indicator-feeds/index.ts":"2","/home/tempuser-ld8s1t/run/codegen-output/cloudflare/cloudflare-node/src/resources/intel/indicator-feeds/indicator-feeds.ts":"3"},{"size":319,"mtime":1758917387039},{"size":857,"mtime":1758917387039},{"size":10324,"mtime":1758917387039}]
+[{"/home/tempuser-1c50sc/run/codegen-output/cloudflare/cloudflare-node/src/resources/ai/to-markdown.ts":"1","/home/tempuser-1c50sc/run/codegen-output/cloudflare/cloudflare-node/tests/api-resources/ai/to-markdown.test.ts":"2","/home/tempuser-1c50sc/run/codegen-output/cloudflare/cloudflare-node/src/resources/ai/ai.ts":"3","/home/tempuser-1c50sc/run/codegen-output/cloudflare/cloudflare-node/src/resources/ai/index.ts":"4"},{"size":1733,"mtime":1759183057642},{"size":1257,"mtime":1759183057642},{"size":26942,"mtime":1759183057642},{"size":776,"mtime":1759183057642}]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 1822
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-ca8fbfa82d19dca400ec61b8c93392de1acd157860e435419f9a5e9ec8c586e0.yml
 openapi_spec_hash: 77d55c70bc3824ac61bd056e2319ee18
-config_hash: 4bd8c8b19860de3e5da0f6dfb78ab679
+config_hash: 9fad1bedf93f562258b7ce34e98e2e7d

api.md

@@ -8633,6 +8633,16 @@ Methods:
 
 - <code title="get /accounts/{account_id}/ai/models/schema">client.ai.models.schema.<a href="./src/resources/ai/models/schema.ts">get</a>({ ...params }) -> SchemaGetResponse</code>
 
+## ToMarkdown
+
+Types:
+
+- <code><a href="./src/resources/ai/to-markdown.ts">ToMarkdownTransformResponse</a></code>
+
+Methods:
+
+- <code title="post /accounts/{account_id}/ai/tomarkdown">client.ai.toMarkdown.<a href="./src/resources/ai/to-markdown.ts">transform</a>(body, { ...params }) -> ToMarkdownTransformResponsesSinglePage</code>
+
 # SecurityCenter
 
 ## Insights

scripts/detect-breaking-changes

@@ -730,6 +730,7 @@ TEST_PATHS=(
 	tests/api-resources/ai/tasks.test.ts
 	tests/api-resources/ai/models/models.test.ts
 	tests/api-resources/ai/models/schema.test.ts
+	tests/api-resources/ai/to-markdown.test.ts
 	tests/api-resources/security-center/security-center.test.ts
 	tests/api-resources/security-center/insights/insights.test.ts
 	tests/api-resources/security-center/insights/class.test.ts

src/resources/ai/ai.ts

@@ -6,6 +6,13 @@ import * as AuthorsAPI from './authors';
 import { AuthorListParams, AuthorListResponse, AuthorListResponsesSinglePage, Authors } from './authors';
 import * as TasksAPI from './tasks';
 import { TaskListParams, TaskListResponse, TaskListResponsesSinglePage, Tasks } from './tasks';
+import * as ToMarkdownAPI from './to-markdown';
+import {
+  ToMarkdown,
+  ToMarkdownTransformParams,
+  ToMarkdownTransformResponse,
+  ToMarkdownTransformResponsesSinglePage,
+} from './to-markdown';
 import * as FinetunesAPI from './finetunes/finetunes';
 import {
   FinetuneCreateParams,
@@ -27,6 +34,7 @@ export class AI extends APIResource {
   authors: AuthorsAPI.Authors = new AuthorsAPI.Authors(this._client);
   tasks: TasksAPI.Tasks = new TasksAPI.Tasks(this._client);
   models: ModelsAPI.Models = new ModelsAPI.Models(this._client);
+  toMarkdown: ToMarkdownAPI.ToMarkdown = new ToMarkdownAPI.ToMarkdown(this._client);
 
   /**
    * This endpoint provides users with the capability to run specific AI models
@@ -1054,6 +1062,8 @@ AI.Tasks = Tasks;
 AI.TaskListResponsesSinglePage = TaskListResponsesSinglePage;
 AI.Models = Models;
 AI.ModelListResponsesV4PagePaginationArray = ModelListResponsesV4PagePaginationArray;
+AI.ToMarkdown = ToMarkdown;
+AI.ToMarkdownTransformResponsesSinglePage = ToMarkdownTransformResponsesSinglePage;
 
 export declare namespace AI {
   export { type AIRunResponse as AIRunResponse, type AIRunParams as AIRunParams };
@@ -1086,4 +1096,11 @@ export declare namespace AI {
     ModelListResponsesV4PagePaginationArray as ModelListResponsesV4PagePaginationArray,
     type ModelListParams as ModelListParams,
   };
+
+  export {
+    ToMarkdown as ToMarkdown,
+    type ToMarkdownTransformResponse as ToMarkdownTransformResponse,
+    ToMarkdownTransformResponsesSinglePage as ToMarkdownTransformResponsesSinglePage,
+    type ToMarkdownTransformParams as ToMarkdownTransformParams,
+  };
 }

src/resources/ai/index.ts

@@ -21,3 +21,9 @@ export {
   type ModelListParams,
 } from './models/index';
 export { TaskListResponsesSinglePage, Tasks, type TaskListResponse, type TaskListParams } from './tasks';
+export {
+  ToMarkdownTransformResponsesSinglePage,
+  ToMarkdown,
+  type ToMarkdownTransformResponse,
+  type ToMarkdownTransformParams,
+} from './to-markdown';

src/resources/ai/to-markdown.ts

@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../resource';
+import * as Core from '../../core';
+import { SinglePage } from '../../pagination';
+import { type BlobLike } from '../../uploads';
+
+export class ToMarkdown extends APIResource {
+  /**
+   * Convert Files into Markdown
+   */
+  transform(
+    body: string | ArrayBufferView | ArrayBuffer | BlobLike,
+    params: ToMarkdownTransformParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<ToMarkdownTransformResponsesSinglePage, ToMarkdownTransformResponse> {
+    const { account_id } = params;
+    return this._client.getAPIList(
+      `/accounts/${account_id}/ai/tomarkdown`,
+      ToMarkdownTransformResponsesSinglePage,
+      {
+        body: body,
+        method: 'post',
+        ...options,
+        headers: { 'Content-Type': 'application/octet-stream', ...options?.headers },
+        __binaryRequest: true,
+      },
+    );
+  }
+}
+
+export class ToMarkdownTransformResponsesSinglePage extends SinglePage<ToMarkdownTransformResponse> {}
+
+export interface ToMarkdownTransformResponse {
+  data: string;
+
+  format: string;
+
+  mimeType: string;
+
+  name: string;
+
+  tokens: string;
+}
+
+export interface ToMarkdownTransformParams {
+  /**
+   * Path param:
+   */
+  account_id: string;
+}
+
+ToMarkdown.ToMarkdownTransformResponsesSinglePage = ToMarkdownTransformResponsesSinglePage;
+
+export declare namespace ToMarkdown {
+  export {
+    type ToMarkdownTransformResponse as ToMarkdownTransformResponse,
+    ToMarkdownTransformResponsesSinglePage as ToMarkdownTransformResponsesSinglePage,
+    type ToMarkdownTransformParams as ToMarkdownTransformParams,
+  };
+}

tests/api-resources/ai/to-markdown.test.ts

@@ -0,0 +1,33 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import Cloudflare, { toFile } from 'cloudflare';
+import { Response } from 'node-fetch';
+
+const client = new Cloudflare({
+  apiKey: '144c9defac04969c7bfad8efaa8ea194',
+  apiEmail: '[email protected]',
+  baseURL: process.env['TEST_API_BASE_URL'] ?? 'http://127.0.0.1:4010',
+});
+
+describe('resource toMarkdown', () => {
+  test('transform: only required params', async () => {
+    const responsePromise = client.ai.toMarkdown.transform(
+      await toFile(Buffer.from('# my file contents'), 'README.md'),
+      { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+    );
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+
+  test('transform: required and optional params', async () => {
+    const response = await client.ai.toMarkdown.transform(
+      await toFile(Buffer.from('# my file contents'), 'README.md'),
+      { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+    );
+  });
+});