feat(attachments): create context-aware helper for attachments

src/api.ts

@@ -1,6 +1,7 @@
 import axios, { AxiosError } from 'axios';
 import FormData from 'form-data';
 import { createReadStream } from 'fs';
+import { ReadStream } from 'fs';
 import { v4 as uuidv4 } from 'uuid';
 
 import { LiteralClient } from '.';
@@ -21,6 +22,7 @@ import {
   PersistedGeneration
 } from './generation';
 import {
+  Attachment,
   CleanThreadFields,
   Dataset,
   DatasetExperiment,
@@ -327,6 +329,28 @@ function addGenerationsToDatasetQueryBuilder(generationIds: string[]) {
     `;
 }
 
+type UploadFileBaseParams = {
+  id?: Maybe<string>;
+  threadId?: string;
+  mime?: Maybe<string>;
+};
+type UploadFileParamsWithPath = UploadFileBaseParams & {
+  path: string;
+};
+type UploadFileParamsWithContent = UploadFileBaseParams & {
+  content:
+    | ReadableStream<any>
+    | ReadStream
+    | Buffer
+    | File
+    | Blob
+    | ArrayBuffer;
+};
+type CreateAttachmentParams = {
+  name?: string;
+  metadata?: Maybe<Record<string, any>>;
+};
+
 export class API {
   /** @ignore */
   private client: LiteralClient;
@@ -596,19 +620,25 @@ export class API {
    * @returns An object containing the `objectKey` of the uploaded file and the signed `url`, or `null` values if the upload fails.
    * @throws {Error} Throws an error if neither `content` nor `path` is provided, or if the server response is invalid.
    */
+
+  async uploadFile(params: UploadFileParamsWithContent): Promise<{
+    objectKey: Maybe<string>;
+    url: Maybe<string>;
+  }>;
+  async uploadFile(params: UploadFileParamsWithPath): Promise<{
+    objectKey: Maybe<string>;
+    url: Maybe<string>;
+  }>;
   async uploadFile({
     content,
     path,
     id,
     threadId,
     mime
-  }: {
-    content?: Maybe<any>;
-    path?: Maybe<string>;
-    id?: Maybe<string>;
-    threadId: string;
-    mime?: Maybe<string>;
-  }) {
+  }: UploadFileParamsWithContent & UploadFileParamsWithPath): Promise<{
+    objectKey: Maybe<string>;
+    url: Maybe<string>;
+  }> {
     if (!content && !path) {
       throw new Error('Either content or path must be provided');
     }
@@ -678,6 +708,63 @@ export class API {
     }
   }
 
+  async createAttachment(
+    params: UploadFileParamsWithContent & CreateAttachmentParams
+  ): Promise<Attachment>;
+  async createAttachment(
+    params: UploadFileParamsWithPath & CreateAttachmentParams
+  ): Promise<Attachment>;
+  async createAttachment(
+    params: UploadFileParamsWithContent &
+      UploadFileParamsWithPath &
+      CreateAttachmentParams
+  ): Promise<Attachment> {
+    if (params.content instanceof Blob) {
+      params.content = Buffer.from(await params.content.arrayBuffer());
+    }
+    if (params.content instanceof ArrayBuffer) {
+      params.content = Buffer.from(params.content);
+    }
+
+    let threadFromStore: Thread | null = null;
+    try {
+      threadFromStore = this.client.getCurrentThread();
+    } catch (error) {
+      // Ignore error thrown if getCurrentThread is called outside of a context
+    }
+
+    let stepFromStore: Step | null = null;
+    try {
+      stepFromStore = this.client.getCurrentStep();
+    } catch (error) {
+      // Ignore error thrown if getCurrentStep is called outside of a context
+    }
+
+    if (threadFromStore) {
+      params.threadId = threadFromStore.id;
+    }
+
+    const { objectKey, url } = await this.uploadFile(params);
+
+    const attachment = new Attachment({
+      name: params.name,
+      objectKey,
+      mime: params.mime,
+      metadata: params.metadata,
+      url
+    });
+
+    if (stepFromStore) {
+      if (!stepFromStore.attachments) {
+        stepFromStore.attachments = [];
+      }
+
+      stepFromStore.attachments.push(attachment);
+    }
+
+    return attachment;
+  }
+
   // Generation
   /**
    * Retrieves a paginated list of Generations based on the provided filters and sorting order.

src/openai.ts

@@ -42,21 +42,16 @@ class OpenAIAssistantSyncer {
         );
         const mime = 'image/png';
 
-        const { objectKey } = await this.client.api.uploadFile({
-          threadId: litThreadId,
-          id: attachmentId,
-          content: file.body,
-          mime
-        });
-
-        const attachment = new Attachment({
-          name: content.image_file.file_id,
-          id: attachmentId,
-          objectKey,
-          mime
-        });
-
-        attachments.push(attachment);
+        if (file.body) {
+          const attachment = await this.client.api.createAttachment({
+            threadId: litThreadId,
+            id: attachmentId,
+            content: file.body,
+            mime
+          });
+
+          attachments.push(attachment);
+        }
       } else if (content.type === 'text') {
         output.content += content.text.value;
       }

tests/api.test.ts

@@ -1,14 +1,7 @@
 import 'dotenv/config';
-import { createReadStream } from 'fs';
 import { v4 as uuidv4 } from 'uuid';
 
-import {
-  Attachment,
-  ChatGeneration,
-  Dataset,
-  LiteralClient,
-  Score
-} from '../src';
+import { ChatGeneration, Dataset, LiteralClient, Score } from '../src';
 
 describe('End to end tests for the SDK', function () {
   let client: LiteralClient;
@@ -336,42 +329,6 @@ describe('End to end tests for the SDK', function () {
     expect(scores[1].scorer).toBe('openai:gpt-3.5-turbo');
   });
 
-  it('should test attachment', async function () {
-    const thread = await client.thread({ id: uuidv4() });
-    // Upload an attachment
-    const fileStream = createReadStream('./tests/chainlit-logo.png');
-    const mime = 'image/png';
-
-    const { objectKey } = await client.api.uploadFile({
-      threadId: thread.id,
-      content: fileStream,
-      mime
-    });
-
-    const attachment = new Attachment({
-      name: 'test',
-      objectKey,
-      mime
-    });
-
-    const step = await thread
-      .step({
-        name: 'test',
-        type: 'run',
-        attachments: [attachment]
-      })
-      .send();
-
-    await new Promise((resolve) => setTimeout(resolve, 1000));
-
-    const fetchedStep = await client.api.getStep(step.id!);
-    expect(fetchedStep?.attachments?.length).toBe(1);
-    expect(fetchedStep?.attachments![0].objectKey).toBe(objectKey);
-    expect(fetchedStep?.attachments![0].url).toBeDefined();
-
-    await client.api.deleteThread(thread.id);
-  });
-
   it('should get project id', async () => {
     const projectId = await client.api.getProjectId();
     expect(projectId).toEqual(expect.any(String));

tests/attachments.test.ts

@@ -0,0 +1,96 @@
+import 'dotenv/config';
+import { createReadStream, readFileSync } from 'fs';
+
+import { Attachment, LiteralClient, Maybe } from '../src';
+
+const url = process.env.LITERAL_API_URL;
+const apiKey = process.env.LITERAL_API_KEY;
+if (!url || !apiKey) {
+  throw new Error('Missing environment variables');
+}
+const client = new LiteralClient(apiKey, url);
+
+const filePath = './tests/chainlit-logo.png';
+const mime = 'image/png';
+
+function removeVariableParts(url: string) {
+  return url.split('X-Amz-Date')[0].split('X-Goog-Date')[0];
+}
+
+describe('Attachments', () => {
+  describe('Uploading a file', () => {
+    const stream = createReadStream(filePath);
+    const buffer = readFileSync(filePath);
+    const arrayBuffer = buffer.buffer;
+    const blob = new Blob([buffer]);
+    // We wrap the blob in a blob and simulate the structure of a File
+    const file = new Blob([blob], { type: 'image/jpeg' });
+
+    it.each([
+      { type: 'Stream', content: stream! },
+      { type: 'Buffer', content: buffer! },
+      { type: 'ArrayBuffer', content: arrayBuffer! },
+      { type: 'Blob', content: blob! },
+      { type: 'File', content: file! }
+    ])('handles $type objects', async function ({ type, content }) {
+      const attachment = await client.api.createAttachment({
+        content,
+        mime,
+        name: `Attachment ${type}`,
+        metadata: { type }
+      });
+
+      const step = await client
+        .run({
+          name: `Test ${type}`,
+          attachments: [attachment]
+        })
+        .send();
+
+      await new Promise((resolve) => setTimeout(resolve, 1000));
+
+      const fetchedStep = await client.api.getStep(step.id!);
+
+      const urlWithoutVariables = removeVariableParts(attachment.url!);
+      const fetchedUrlWithoutVariables = removeVariableParts(
+        fetchedStep?.attachments![0].url as string
+      );
+
+      expect(fetchedStep?.attachments?.length).toBe(1);
+      expect(fetchedStep?.attachments![0].objectKey).toEqual(
+        attachment.objectKey
+      );
+      expect(fetchedStep?.attachments![0].name).toEqual(attachment.name);
+      expect(fetchedStep?.attachments![0].metadata).toEqual(
+        attachment.metadata
+      );
+      expect(urlWithoutVariables).toEqual(fetchedUrlWithoutVariables);
+    });
+  });
+
+  describe('Handling context', () => {
+    it('attaches the attachment to the step in the context', async () => {
+      const stream = createReadStream(filePath);
+
+      let stepId: Maybe<string>;
+      let attachment: Maybe<Attachment>;
+
+      await client.run({ name: 'Attachment test ' }).wrap(async () => {
+        stepId = client.getCurrentStep().id!;
+        attachment = await client.api.createAttachment({
+          content: stream!,
+          mime,
+          name: 'Attachment',
+          metadata: { type: 'Stream' }
+        });
+      });
+
+      await new Promise((resolve) => setTimeout(resolve, 1000));
+
+      const fetchedStep = await client.api.getStep(stepId!);
+
+      expect(fetchedStep?.attachments?.length).toBe(1);
+      expect(fetchedStep?.attachments![0].id).toEqual(attachment!.id);
+    });
+  });
+});