@assistant-ui/react 0.10.21 → 0.10.22

package/dist/cloud/AssistantCloud.d.ts

@@ -2,12 +2,14 @@ import { AssistantCloudConfig } from "./AssistantCloudAPI";
 import { AssistantCloudAuthTokens } from "./AssistantCloudAuthTokens";
 import { AssistantCloudRuns } from "./AssistantCloudRuns";
 import { AssistantCloudThreads } from "./AssistantCloudThreads";
+import { AssistantCloudFiles } from "./AssistantCloudFiles";
 export declare class AssistantCloud {
     readonly threads: AssistantCloudThreads;
     readonly auth: {
         tokens: AssistantCloudAuthTokens;
     };
     readonly runs: AssistantCloudRuns;
+    readonly files: AssistantCloudFiles;
     constructor(config: AssistantCloudConfig);
 }
 //# sourceMappingURL=AssistantCloud.d.ts.map

package/dist/cloud/AssistantCloud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCloud.d.ts","sourceRoot":"","sources":["../../src/cloud/AssistantCloud.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqB,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,qBAAa,cAAc;IACzB,SAAgB,OAAO,wBAAC;IACxB,SAAgB,IAAI;;MAAC;IACrB,SAAgB,IAAI,qBAAC;gBAET,MAAM,EAAE,oBAAoB;CAQzC"}
+{"version":3,"file":"AssistantCloud.d.ts","sourceRoot":"","sources":["../../src/cloud/AssistantCloud.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqB,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,qBAAa,cAAc;IACzB,SAAgB,OAAO,wBAAC;IACxB,SAAgB,IAAI;;MAAC;IACrB,SAAgB,IAAI,qBAAC;IACrB,SAAgB,KAAK,sBAAC;gBAEV,MAAM,EAAE,oBAAoB;CASzC"}

package/dist/cloud/AssistantCloud.js

@@ -3,10 +3,12 @@ import { AssistantCloudAPI } from "./AssistantCloudAPI.js";
 import { AssistantCloudAuthTokens } from "./AssistantCloudAuthTokens.js";
 import { AssistantCloudRuns } from "./AssistantCloudRuns.js";
 import { AssistantCloudThreads } from "./AssistantCloudThreads.js";
+import { AssistantCloudFiles } from "./AssistantCloudFiles.js";
 var AssistantCloud = class {
   threads;
   auth;
   runs;
+  files;
   constructor(config) {
     const api = new AssistantCloudAPI(config);
     this.threads = new AssistantCloudThreads(api);
@@ -14,6 +16,7 @@ var AssistantCloud = class {
       tokens: new AssistantCloudAuthTokens(api)
     };
     this.runs = new AssistantCloudRuns(api);
+    this.files = new AssistantCloudFiles(api);
   }
 };
 export {

package/dist/cloud/AssistantCloud.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cloud/AssistantCloud.tsx"],"sourcesContent":["import { AssistantCloudAPI, AssistantCloudConfig } from \"./AssistantCloudAPI\";\nimport { AssistantCloudAuthTokens } from \"./AssistantCloudAuthTokens\";\nimport { AssistantCloudRuns } from \"./AssistantCloudRuns\";\nimport { AssistantCloudThreads } from \"./AssistantCloudThreads\";\n\nexport class AssistantCloud {\n  public readonly threads;\n  public readonly auth;\n  public readonly runs;\n\n  constructor(config: AssistantCloudConfig) {\n    const api = new AssistantCloudAPI(config);\n    this.threads = new AssistantCloudThreads(api);\n    this.auth = {\n      tokens: new AssistantCloudAuthTokens(api),\n    };\n    this.runs = new AssistantCloudRuns(api);\n  }\n}\n"],"mappings":";AAAA,SAAS,yBAA+C;AACxD,SAAS,gCAAgC;AACzC,SAAS,0BAA0B;AACnC,SAAS,6BAA6B;AAE/B,IAAM,iBAAN,MAAqB;AAAA,EACV;AAAA,EACA;AAAA,EACA;AAAA,EAEhB,YAAY,QAA8B;AACxC,UAAM,MAAM,IAAI,kBAAkB,MAAM;AACxC,SAAK,UAAU,IAAI,sBAAsB,GAAG;AAC5C,SAAK,OAAO;AAAA,MACV,QAAQ,IAAI,yBAAyB,GAAG;AAAA,IAC1C;AACA,SAAK,OAAO,IAAI,mBAAmB,GAAG;AAAA,EACxC;AACF;","names":[]}
+{"version":3,"sources":["../../src/cloud/AssistantCloud.tsx"],"sourcesContent":["import { AssistantCloudAPI, AssistantCloudConfig } from \"./AssistantCloudAPI\";\nimport { AssistantCloudAuthTokens } from \"./AssistantCloudAuthTokens\";\nimport { AssistantCloudRuns } from \"./AssistantCloudRuns\";\nimport { AssistantCloudThreads } from \"./AssistantCloudThreads\";\nimport { AssistantCloudFiles } from \"./AssistantCloudFiles\";\n\nexport class AssistantCloud {\n  public readonly threads;\n  public readonly auth;\n  public readonly runs;\n  public readonly files;\n\n  constructor(config: AssistantCloudConfig) {\n    const api = new AssistantCloudAPI(config);\n    this.threads = new AssistantCloudThreads(api);\n    this.auth = {\n      tokens: new AssistantCloudAuthTokens(api),\n    };\n    this.runs = new AssistantCloudRuns(api);\n    this.files = new AssistantCloudFiles(api);\n  }\n}\n"],"mappings":";AAAA,SAAS,yBAA+C;AACxD,SAAS,gCAAgC;AACzC,SAAS,0BAA0B;AACnC,SAAS,6BAA6B;AACtC,SAAS,2BAA2B;AAE7B,IAAM,iBAAN,MAAqB;AAAA,EACV;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEhB,YAAY,QAA8B;AACxC,UAAM,MAAM,IAAI,kBAAkB,MAAM;AACxC,SAAK,UAAU,IAAI,sBAAsB,GAAG;AAC5C,SAAK,OAAO;AAAA,MACV,QAAQ,IAAI,yBAAyB,GAAG;AAAA,IAC1C;AACA,SAAK,OAAO,IAAI,mBAAmB,GAAG;AACtC,SAAK,QAAQ,IAAI,oBAAoB,GAAG;AAAA,EAC1C;AACF;","names":[]}

package/dist/cloud/AssistantCloudFiles.d.ts

@@ -0,0 +1,27 @@
+import { AssistantCloudAPI } from "./AssistantCloudAPI";
+type PdfToImagesRequestBody = {
+    file_blob?: string | undefined;
+    file_url?: string | undefined;
+};
+type PdfToImagesResponse = {
+    success: boolean;
+    urls: string[];
+    message: string;
+};
+type GeneratePresignedUploadUrlRequestBody = {
+    filename: string;
+};
+type GeneratePresignedUploadUrlResponse = {
+    success: boolean;
+    signedUrl: string;
+    expiresAt: string;
+    publicUrl: string;
+};
+export declare class AssistantCloudFiles {
+    private cloud;
+    constructor(cloud: AssistantCloudAPI);
+    pdfToImages(body: PdfToImagesRequestBody): Promise<PdfToImagesResponse>;
+    generatePresignedUploadUrl(body: GeneratePresignedUploadUrlRequestBody): Promise<GeneratePresignedUploadUrlResponse>;
+}
+export {};
+//# sourceMappingURL=AssistantCloudFiles.d.ts.map

package/dist/cloud/AssistantCloudFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantCloudFiles.d.ts","sourceRoot":"","sources":["../../src/cloud/AssistantCloudFiles.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,KAAK,sBAAsB,GAAG;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,qCAAqC,GAAG;IAC3C,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,kCAAkC,GAAG;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,qBAAa,mBAAmB;IAClB,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,iBAAiB;IAE/B,WAAW,CACtB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAOlB,0BAA0B,CACrC,IAAI,EAAE,qCAAqC,GAC1C,OAAO,CAAC,kCAAkC,CAAC;CAM/C"}

package/dist/cloud/AssistantCloudFiles.js

@@ -0,0 +1,22 @@
+// src/cloud/AssistantCloudFiles.tsx
+var AssistantCloudFiles = class {
+  constructor(cloud) {
+    this.cloud = cloud;
+  }
+  async pdfToImages(body) {
+    return this.cloud.makeRequest("/files/pdf-to-images", {
+      method: "POST",
+      body
+    });
+  }
+  async generatePresignedUploadUrl(body) {
+    return this.cloud.makeRequest("/files/attachments/generate-presigned-upload-url", {
+      method: "POST",
+      body
+    });
+  }
+};
+export {
+  AssistantCloudFiles
+};
+//# sourceMappingURL=AssistantCloudFiles.js.map

package/dist/cloud/AssistantCloudFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cloud/AssistantCloudFiles.tsx"],"sourcesContent":["import { AssistantCloudAPI } from \"./AssistantCloudAPI\";\n\ntype PdfToImagesRequestBody = {\n  file_blob?: string | undefined;\n  file_url?: string | undefined;\n};\n\ntype PdfToImagesResponse = {\n  success: boolean;\n  urls: string[];\n  message: string;\n};\n\ntype GeneratePresignedUploadUrlRequestBody = {\n  filename: string;\n};\n\ntype GeneratePresignedUploadUrlResponse = {\n  success: boolean;\n  signedUrl: string;\n  expiresAt: string;\n  publicUrl: string;\n};\n\nexport class AssistantCloudFiles {\n  constructor(private cloud: AssistantCloudAPI) {}\n\n  public async pdfToImages(\n    body: PdfToImagesRequestBody,\n  ): Promise<PdfToImagesResponse> {\n    return this.cloud.makeRequest(\"/files/pdf-to-images\", {\n      method: \"POST\",\n      body,\n    });\n  }\n\n  public async generatePresignedUploadUrl(\n    body: GeneratePresignedUploadUrlRequestBody,\n  ): Promise<GeneratePresignedUploadUrlResponse> {\n    return this.cloud.makeRequest(\"/files/attachments/generate-presigned-upload-url\", {\n      method: \"POST\",\n      body,\n    });\n  }\n} "],"mappings":";AAwBO,IAAM,sBAAN,MAA0B;AAAA,EAC/B,YAAoB,OAA0B;AAA1B;AAAA,EAA2B;AAAA,EAE/C,MAAa,YACX,MAC8B;AAC9B,WAAO,KAAK,MAAM,YAAY,wBAAwB;AAAA,MACpD,QAAQ;AAAA,MACR;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAa,2BACX,MAC6C;AAC7C,WAAO,KAAK,MAAM,YAAY,oDAAoD;AAAA,MAChF,QAAQ;AAAA,MACR;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/runtimes/local/useLocalRuntime.d.ts

@@ -1,5 +1,6 @@
 import type { ChatModelAdapter } from "./ChatModelAdapter";
-import { LocalRuntimeOptions } from "./LocalRuntimeOptions";
+import type { LocalRuntimeOptions } from "./LocalRuntimeOptions";
 import { AssistantRuntimeImpl } from "../../internal";
+export declare const useLocalThreadRuntime: (adapter: ChatModelAdapter, { initialMessages, ...options }: LocalRuntimeOptions) => AssistantRuntimeImpl;
 export declare const useLocalRuntime: (adapter: ChatModelAdapter, { cloud, ...options }?: LocalRuntimeOptions) => AssistantRuntimeImpl;
 //# sourceMappingURL=useLocalRuntime.d.ts.map

package/dist/runtimes/local/useLocalRuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLocalRuntime.d.ts","sourceRoot":"","sources":["../../../src/runtimes/local/useLocalRuntime.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAI5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAwCtD,eAAO,MAAM,eAAe,GAC1B,SAAS,gBAAgB,EACzB,wBAAuB,mBAAwB,yBAShD,CAAC"}
+{"version":3,"file":"useLocalRuntime.d.ts","sourceRoot":"","sources":["../../../src/runtimes/local/useLocalRuntime.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAIjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,eAAO,MAAM,qBAAqB,GAChC,SAAS,gBAAgB,EACzB,iCAAiC,mBAAmB,yBAkCrD,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,SAAS,gBAAgB,EACzB,wBAAuB,mBAAwB,yBAShD,CAAC"}

package/dist/runtimes/local/useLocalRuntime.js

@@ -46,6 +46,7 @@ var useLocalRuntime = (adapter, { cloud, ...options } = {}) => {
   });
 };
 export {
-  useLocalRuntime
+  useLocalRuntime,
+  useLocalThreadRuntime
 };
 //# sourceMappingURL=useLocalRuntime.js.map

package/dist/runtimes/local/useLocalRuntime.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/runtimes/local/useLocalRuntime.tsx"],"sourcesContent":["\"use client\";\n\nimport { useEffect, useMemo, useState } from \"react\";\nimport type { ChatModelAdapter } from \"./ChatModelAdapter\";\nimport { LocalRuntimeCore } from \"./LocalRuntimeCore\";\nimport { LocalRuntimeOptions } from \"./LocalRuntimeOptions\";\nimport { useRuntimeAdapters } from \"../adapters/RuntimeAdapterProvider\";\nimport { useRemoteThreadListRuntime } from \"../remote-thread-list/useRemoteThreadListRuntime\";\nimport { useCloudThreadListAdapter } from \"../remote-thread-list/adapter/cloud\";\nimport { AssistantRuntimeImpl } from \"../../internal\";\n\nconst useLocalThreadRuntime = (\n  adapter: ChatModelAdapter,\n  { initialMessages, ...options }: LocalRuntimeOptions,\n) => {\n  const { modelContext, ...threadListAdapters } = useRuntimeAdapters() ?? {};\n  const opt = useMemo(\n    () => ({\n      ...options,\n      adapters: {\n        ...threadListAdapters,\n        ...options.adapters,\n        chatModel: adapter,\n      },\n    }),\n    [adapter, options, threadListAdapters],\n  );\n\n  const [runtime] = useState(() => new LocalRuntimeCore(opt, initialMessages));\n\n  useEffect(() => {\n    return () => {\n      runtime.threads.getMainThreadRuntimeCore().detach();\n    };\n  }, [runtime]);\n\n  useEffect(() => {\n    runtime.threads.getMainThreadRuntimeCore().__internal_setOptions(opt);\n    runtime.threads.getMainThreadRuntimeCore().__internal_load();\n  }, [runtime, opt]);\n\n  useEffect(() => {\n    if (!modelContext) return undefined;\n    return runtime.registerModelContextProvider(modelContext);\n  }, [modelContext, runtime]);\n\n  return useMemo(() => new AssistantRuntimeImpl(runtime), [runtime]);\n};\n\nexport const useLocalRuntime = (\n  adapter: ChatModelAdapter,\n  { cloud, ...options }: LocalRuntimeOptions = {},\n) => {\n  const cloudAdapter = useCloudThreadListAdapter({ cloud });\n  return useRemoteThreadListRuntime({\n    runtimeHook: function RuntimeHook() {\n      return useLocalThreadRuntime(adapter, options);\n    },\n    adapter: cloudAdapter,\n  });\n};\n"],"mappings":";;;AAEA,SAAS,WAAW,SAAS,gBAAgB;AAE7C,SAAS,wBAAwB;AAEjC,SAAS,0BAA0B;AACnC,SAAS,kCAAkC;AAC3C,SAAS,iCAAiC;AAC1C,SAAS,4BAA4B;AAErC,IAAM,wBAAwB,CAC5B,SACA,EAAE,iBAAiB,GAAG,QAAQ,MAC3B;AACH,QAAM,EAAE,cAAc,GAAG,mBAAmB,IAAI,mBAAmB,KAAK,CAAC;AACzE,QAAM,MAAM;AAAA,IACV,OAAO;AAAA,MACL,GAAG;AAAA,MACH,UAAU;AAAA,QACR,GAAG;AAAA,QACH,GAAG,QAAQ;AAAA,QACX,WAAW;AAAA,MACb;AAAA,IACF;AAAA,IACA,CAAC,SAAS,SAAS,kBAAkB;AAAA,EACvC;AAEA,QAAM,CAAC,OAAO,IAAI,SAAS,MAAM,IAAI,iBAAiB,KAAK,eAAe,CAAC;AAE3E,YAAU,MAAM;AACd,WAAO,MAAM;AACX,cAAQ,QAAQ,yBAAyB,EAAE,OAAO;AAAA,IACpD;AAAA,EACF,GAAG,CAAC,OAAO,CAAC;AAEZ,YAAU,MAAM;AACd,YAAQ,QAAQ,yBAAyB,EAAE,sBAAsB,GAAG;AACpE,YAAQ,QAAQ,yBAAyB,EAAE,gBAAgB;AAAA,EAC7D,GAAG,CAAC,SAAS,GAAG,CAAC;AAEjB,YAAU,MAAM;AACd,QAAI,CAAC,aAAc,QAAO;AAC1B,WAAO,QAAQ,6BAA6B,YAAY;AAAA,EAC1D,GAAG,CAAC,cAAc,OAAO,CAAC;AAE1B,SAAO,QAAQ,MAAM,IAAI,qBAAqB,OAAO,GAAG,CAAC,OAAO,CAAC;AACnE;AAEO,IAAM,kBAAkB,CAC7B,SACA,EAAE,OAAO,GAAG,QAAQ,IAAyB,CAAC,MAC3C;AACH,QAAM,eAAe,0BAA0B,EAAE,MAAM,CAAC;AACxD,SAAO,2BAA2B;AAAA,IAChC,aAAa,SAAS,cAAc;AAClC,aAAO,sBAAsB,SAAS,OAAO;AAAA,IAC/C;AAAA,IACA,SAAS;AAAA,EACX,CAAC;AACH;","names":[]}
+{"version":3,"sources":["../../../src/runtimes/local/useLocalRuntime.tsx"],"sourcesContent":["\"use client\";\n\nimport { useEffect, useMemo, useState } from \"react\";\nimport type { ChatModelAdapter } from \"./ChatModelAdapter\";\nimport { LocalRuntimeCore } from \"./LocalRuntimeCore\";\nimport type { LocalRuntimeOptions } from \"./LocalRuntimeOptions\";\nimport { useRuntimeAdapters } from \"../adapters/RuntimeAdapterProvider\";\nimport { useRemoteThreadListRuntime } from \"../remote-thread-list/useRemoteThreadListRuntime\";\nimport { useCloudThreadListAdapter } from \"../remote-thread-list/adapter/cloud\";\nimport { AssistantRuntimeImpl } from \"../../internal\";\n\nexport const useLocalThreadRuntime = (\n  adapter: ChatModelAdapter,\n  { initialMessages, ...options }: LocalRuntimeOptions,\n) => {\n  const { modelContext, ...threadListAdapters } = useRuntimeAdapters() ?? {};\n  const opt = useMemo(\n    () => ({\n      ...options,\n      adapters: {\n        ...threadListAdapters,\n        ...options.adapters,\n        chatModel: adapter,\n      },\n    }),\n    [adapter, options, threadListAdapters],\n  );\n\n  const [runtime] = useState(() => new LocalRuntimeCore(opt, initialMessages));\n\n  useEffect(() => {\n    return () => {\n      runtime.threads.getMainThreadRuntimeCore().detach();\n    };\n  }, [runtime]);\n\n  useEffect(() => {\n    runtime.threads.getMainThreadRuntimeCore().__internal_setOptions(opt);\n    runtime.threads.getMainThreadRuntimeCore().__internal_load();\n  }, [runtime, opt]);\n\n  useEffect(() => {\n    if (!modelContext) return undefined;\n    return runtime.registerModelContextProvider(modelContext);\n  }, [modelContext, runtime]);\n\n  return useMemo(() => new AssistantRuntimeImpl(runtime), [runtime]);\n};\n\nexport const useLocalRuntime = (\n  adapter: ChatModelAdapter,\n  { cloud, ...options }: LocalRuntimeOptions = {},\n) => {\n  const cloudAdapter = useCloudThreadListAdapter({ cloud });\n  return useRemoteThreadListRuntime({\n    runtimeHook: function RuntimeHook() {\n      return useLocalThreadRuntime(adapter, options);\n    },\n    adapter: cloudAdapter,\n  });\n};\n"],"mappings":";;;AAEA,SAAS,WAAW,SAAS,gBAAgB;AAE7C,SAAS,wBAAwB;AAEjC,SAAS,0BAA0B;AACnC,SAAS,kCAAkC;AAC3C,SAAS,iCAAiC;AAC1C,SAAS,4BAA4B;AAE9B,IAAM,wBAAwB,CACnC,SACA,EAAE,iBAAiB,GAAG,QAAQ,MAC3B;AACH,QAAM,EAAE,cAAc,GAAG,mBAAmB,IAAI,mBAAmB,KAAK,CAAC;AACzE,QAAM,MAAM;AAAA,IACV,OAAO;AAAA,MACL,GAAG;AAAA,MACH,UAAU;AAAA,QACR,GAAG;AAAA,QACH,GAAG,QAAQ;AAAA,QACX,WAAW;AAAA,MACb;AAAA,IACF;AAAA,IACA,CAAC,SAAS,SAAS,kBAAkB;AAAA,EACvC;AAEA,QAAM,CAAC,OAAO,IAAI,SAAS,MAAM,IAAI,iBAAiB,KAAK,eAAe,CAAC;AAE3E,YAAU,MAAM;AACd,WAAO,MAAM;AACX,cAAQ,QAAQ,yBAAyB,EAAE,OAAO;AAAA,IACpD;AAAA,EACF,GAAG,CAAC,OAAO,CAAC;AAEZ,YAAU,MAAM;AACd,YAAQ,QAAQ,yBAAyB,EAAE,sBAAsB,GAAG;AACpE,YAAQ,QAAQ,yBAAyB,EAAE,gBAAgB;AAAA,EAC7D,GAAG,CAAC,SAAS,GAAG,CAAC;AAEjB,YAAU,MAAM;AACd,QAAI,CAAC,aAAc,QAAO;AAC1B,WAAO,QAAQ,6BAA6B,YAAY;AAAA,EAC1D,GAAG,CAAC,cAAc,OAAO,CAAC;AAE1B,SAAO,QAAQ,MAAM,IAAI,qBAAqB,OAAO,GAAG,CAAC,OAAO,CAAC;AACnE;AAEO,IAAM,kBAAkB,CAC7B,SACA,EAAE,OAAO,GAAG,QAAQ,IAAyB,CAAC,MAC3C;AACH,QAAM,eAAe,0BAA0B,EAAE,MAAM,CAAC;AACxD,SAAO,2BAA2B;AAAA,IAChC,aAAa,SAAS,cAAc;AAClC,aAAO,sBAAsB,SAAS,OAAO;AAAA,IAC/C;AAAA,IACA,SAAS;AAAA,EACX,CAAC;AACH;","names":[]}

package/package.json

@@ -28,7 +28,7 @@
     "conversational-ui",
     "conversational-ai"
   ],
-  "version": "0.10.21",
+  "version": "0.10.22",
   "license": "MIT",
   "type": "module",
   "exports": {
@@ -57,7 +57,7 @@
     "@radix-ui/react-use-callback-ref": "^1.1.1",
     "@radix-ui/react-use-escape-keydown": "^1.1.1",
     "@standard-schema/spec": "^1.0.0",
-    "assistant-stream": "^0.2.14",
+    "assistant-stream": "^0.2.15",
     "json-schema": "^0.4.0",
     "nanoid": "5.1.5",
     "react-textarea-autosize": "^8.5.9",

package/src/cloud/AssistantCloud.tsx

@@ -2,11 +2,13 @@ import { AssistantCloudAPI, AssistantCloudConfig } from "./AssistantCloudAPI";
 import { AssistantCloudAuthTokens } from "./AssistantCloudAuthTokens";
 import { AssistantCloudRuns } from "./AssistantCloudRuns";
 import { AssistantCloudThreads } from "./AssistantCloudThreads";
+import { AssistantCloudFiles } from "./AssistantCloudFiles";
 
 export class AssistantCloud {
   public readonly threads;
   public readonly auth;
   public readonly runs;
+  public readonly files;
 
   constructor(config: AssistantCloudConfig) {
     const api = new AssistantCloudAPI(config);
@@ -15,5 +17,6 @@ export class AssistantCloud {
       tokens: new AssistantCloudAuthTokens(api),
     };
     this.runs = new AssistantCloudRuns(api);
+    this.files = new AssistantCloudFiles(api);
   }
 }

package/src/cloud/AssistantCloudFiles.tsx

@@ -0,0 +1,45 @@
+import { AssistantCloudAPI } from "./AssistantCloudAPI";
+
+type PdfToImagesRequestBody = {
+  file_blob?: string | undefined;
+  file_url?: string | undefined;
+};
+
+type PdfToImagesResponse = {
+  success: boolean;
+  urls: string[];
+  message: string;
+};
+
+type GeneratePresignedUploadUrlRequestBody = {
+  filename: string;
+};
+
+type GeneratePresignedUploadUrlResponse = {
+  success: boolean;
+  signedUrl: string;
+  expiresAt: string;
+  publicUrl: string;
+};
+
+export class AssistantCloudFiles {
+  constructor(private cloud: AssistantCloudAPI) {}
+
+  public async pdfToImages(
+    body: PdfToImagesRequestBody,
+  ): Promise<PdfToImagesResponse> {
+    return this.cloud.makeRequest("/files/pdf-to-images", {
+      method: "POST",
+      body,
+    });
+  }
+
+  public async generatePresignedUploadUrl(
+    body: GeneratePresignedUploadUrlRequestBody,
+  ): Promise<GeneratePresignedUploadUrlResponse> {
+    return this.cloud.makeRequest("/files/attachments/generate-presigned-upload-url", {
+      method: "POST",
+      body,
+    });
+  }
+} 

package/src/runtimes/local/useLocalRuntime.tsx

@@ -3,13 +3,13 @@
 import { useEffect, useMemo, useState } from "react";
 import type { ChatModelAdapter } from "./ChatModelAdapter";
 import { LocalRuntimeCore } from "./LocalRuntimeCore";
-import { LocalRuntimeOptions } from "./LocalRuntimeOptions";
+import type { LocalRuntimeOptions } from "./LocalRuntimeOptions";
 import { useRuntimeAdapters } from "../adapters/RuntimeAdapterProvider";
 import { useRemoteThreadListRuntime } from "../remote-thread-list/useRemoteThreadListRuntime";
 import { useCloudThreadListAdapter } from "../remote-thread-list/adapter/cloud";
 import { AssistantRuntimeImpl } from "../../internal";
 
-const useLocalThreadRuntime = (
+export const useLocalThreadRuntime = (
   adapter: ChatModelAdapter,
   { initialMessages, ...options }: LocalRuntimeOptions,
 ) => {

package/src/tests/AssistantCloudFiles.test.ts

@@ -0,0 +1,521 @@
+import { describe, it, expect, beforeEach, vi, afterEach } from "vitest";
+import { AssistantCloudFiles } from "../cloud/AssistantCloudFiles";
+import { AssistantCloudAPI } from "../cloud/AssistantCloudAPI";
+
+// Mock the AssistantCloudAPI to avoid making real HTTP requests (except for integration tests)
+vi.mock("../cloud/AssistantCloudAPI");
+
+describe("AssistantCloudFiles", () => {
+  let cloudFiles: AssistantCloudFiles;
+  let mockApi: AssistantCloudAPI;
+
+  beforeEach(() => {
+    // Create a mock API instance
+    mockApi = {
+      makeRequest: vi.fn(),
+      makeRawRequest: vi.fn(),
+      _auth: { getAuthHeaders: vi.fn() },
+      _baseUrl: "https://backend.assistant-api.com",
+    } as unknown as AssistantCloudAPI;
+
+    // Create the AssistantCloudFiles instance with the mock API
+    cloudFiles = new AssistantCloudFiles(mockApi);
+  });
+
+  afterEach(() => {
+    vi.clearAllMocks();
+  });
+
+  describe("pdfToImages", () => {
+    /**
+     * Tests successful PDF to images conversion with file_url
+     * This matches the curl request structure provided
+     */
+    it("should successfully convert PDF to images using file_url", async () => {
+      const mockResponse = {
+        success: true,
+        urls: [
+          "https://aui-pdf-processing.5c52327048f352f85fb041947c406ab4.r2.cloudflarestorage.com/images/8eb81c61-dc76-48fd-ab66-25cd84a28c97/page-1.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=8698a7e98d990c6edd11fee3a9d0f3f0%2F20250606%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20250606T035428Z&X-Amz-Expires=3600&X-Amz-Signature=ea26cdd5ff7dc85eba12970137606484b9a8ab2c520f31ddba9cbe5941b20793&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
+          "https://aui-pdf-processing.5c52327048f352f85fb041947c406ab4.r2.cloudflarestorage.com/images/8eb81c61-dc76-48fd-ab66-25cd84a28c97/page-2.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=8698a7e98d990c6edd11fee3a9d0f3f0%2F20250606%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20250606T035428Z&X-Amz-Expires=3600&X-Amz-Signature=3499237770cc4402a60e6cc9b8ce8bd460faade9adf456d2773009f7d07af9cb&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
+          "https://aui-pdf-processing.5c52327048f352f85fb041947c406ab4.r2.cloudflarestorage.com/images/8eb81c61-dc76-48fd-ab66-25cd84a28c97/page-3.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=8698a7e98d990c6edd11fee3a9d0f3f0%2F20250606%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20250606T035429Z&X-Amz-Expires=3600&X-Amz-Signature=663ee073972f1b7b82cede9039ed4bc0a6c08118533a9586e871807baf032bc2&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
+        ],
+        message: "PDF successfully converted to images"
+      };
+
+      // Mock the API call to return our expected response
+      vi.mocked(mockApi.makeRequest).mockResolvedValue(mockResponse);
+
+      const requestBody = {
+        file_url: "https://files.testfile.org/PDF/10MB-TESTFILE.ORG.pdf"
+      };
+
+      const result = await cloudFiles.pdfToImages(requestBody);
+
+      // Verify the API was called correctly
+      expect(mockApi.makeRequest).toHaveBeenCalledWith("/files/pdf-to-images", {
+        method: "POST",
+        body: requestBody,
+      });
+
+      // Verify the response structure
+      expect(result).toEqual(mockResponse);
+      expect(result.success).toBe(true);
+      expect(result.urls).toHaveLength(3);
+      expect(result.message).toBe("PDF successfully converted to images");
+      expect(result.urls[0]).toContain("page-1.png");
+      expect(result.urls[1]).toContain("page-2.png");
+      expect(result.urls[2]).toContain("page-3.png");
+    });
+
+    /**
+     * Tests successful PDF to images conversion with file_blob
+     */
+    it("should successfully convert PDF to images using file_blob", async () => {
+      const mockResponse = {
+        success: true,
+        urls: [
+          "https://example.com/converted-image-1.png",
+          "https://example.com/converted-image-2.png"
+        ],
+        message: "PDF successfully converted to images"
+      };
+
+      vi.mocked(mockApi.makeRequest).mockResolvedValue(mockResponse);
+
+      const requestBody = {
+        file_blob: "data:application/pdf;base64,JVBERi0xLjQKJdPr6eEKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKL01lZGlhQm94IFswIDAgNTk1IDg0Ml0KPj4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA1OTUgODQyXQovQ29udGVudHMgNCAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL0xlbmd0aCA0NAo+PgpzdHJlYW0KQlQKL0YxIDEyIFRmCjEwMCA3MDAgVGQKKFRlc3QgUERGKSBUagoKRVQKZW5kc3RyZWFtCmVuZG9iago1IDAgb2JqCjw8Ci9UeXBlIC9Gb250Ci9CYXNlRm9udCAvSGVsdmV0aWNhCi9TdWJ0eXBlIC9UeXBlMQo+PgplbmRvYmoKNiAwIG9iago8PAovVHlwZSAvRm9udERlc2NyaXB0b3IKL0ZvbnROYW1lIC9IZWx2ZXRpY2EKPj4KZW5kb2JqCnhyZWYKMCA3CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAwOSAwMDAwMCBuIAowMDAwMDAwMDc0IDAwMDAwIG4gCjAwMDAwMDAxMzMgMDAwMDAgbiAKMDAwMDAwMDIwNCAwMDAwMCBuIAowMDAwMDAwMjk5IDAwMDAwIG4gCjAwMDAwMDAzNzYgMDAwMDAgbiAKdHJhaWxlcgo8PAovU2l6ZSA3Ci9Sb290IDEgMCBSCj4+CnN0YXJ0eHJlZgo0MzQKJSVFT0YK"
+      };
+
+      const result = await cloudFiles.pdfToImages(requestBody);
+
+      expect(mockApi.makeRequest).toHaveBeenCalledWith("/files/pdf-to-images", {
+        method: "POST",
+        body: requestBody,
+      });
+
+      expect(result).toEqual(mockResponse);
+      expect(result.success).toBe(true);
+      expect(result.urls).toHaveLength(2);
+    });
+
+    /**
+     * Tests API error handling
+     */
+    it("should handle API errors gracefully", async () => {
+      const errorMessage = "Invalid PDF file";
+      vi.mocked(mockApi.makeRequest).mockRejectedValue(new Error(errorMessage));
+
+      const requestBody = {
+        file_url: "https://invalid-url.com/not-a-pdf.txt"
+      };
+
+      await expect(cloudFiles.pdfToImages(requestBody)).rejects.toThrow(errorMessage);
+
+      expect(mockApi.makeRequest).toHaveBeenCalledWith("/files/pdf-to-images", {
+        method: "POST",
+        body: requestBody,
+      });
+    });
+
+    /**
+     * Tests handling of failed conversion response
+     */
+    it("should handle failed conversion response", async () => {
+      const mockResponse = {
+        success: false,
+        urls: [],
+        message: "Failed to convert PDF: File too large"
+      };
+
+      vi.mocked(mockApi.makeRequest).mockResolvedValue(mockResponse);
+
+      const requestBody = {
+        file_url: "https://example.com/huge-file.pdf"
+      };
+
+      const result = await cloudFiles.pdfToImages(requestBody);
+
+      expect(result.success).toBe(false);
+      expect(result.urls).toHaveLength(0);
+      expect(result.message).toBe("Failed to convert PDF: File too large");
+    });
+
+    /**
+     * Tests that the method works with both file_url and file_blob undefined (edge case)
+     */
+    it("should handle empty request body", async () => {
+      const mockResponse = {
+        success: false,
+        urls: [],
+        message: "No file provided"
+      };
+
+      vi.mocked(mockApi.makeRequest).mockResolvedValue(mockResponse);
+
+      const requestBody = {};
+
+      const result = await cloudFiles.pdfToImages(requestBody);
+
+      expect(mockApi.makeRequest).toHaveBeenCalledWith("/files/pdf-to-images", {
+        method: "POST",
+        body: requestBody,
+      });
+
+      expect(result.success).toBe(false);
+      expect(result.urls).toHaveLength(0);
+    });
+
+    /**
+     * Tests that the method sends the correct request headers and structure
+     * This ensures compatibility with the API key authentication shown in the curl example
+     */
+    it("should make request to correct endpoint with proper structure", async () => {
+      const mockResponse = {
+        success: true,
+        urls: ["https://example.com/image.png"],
+        message: "Success"
+      };
+
+      vi.mocked(mockApi.makeRequest).mockResolvedValue(mockResponse);
+
+      const requestBody = {
+        file_url: "https://files.testfile.org/PDF/10MB-TESTFILE.ORG.pdf"
+      };
+
+      await cloudFiles.pdfToImages(requestBody);
+
+      // Verify the endpoint and method are correct
+      expect(mockApi.makeRequest).toHaveBeenCalledWith("/files/pdf-to-images", {
+        method: "POST",
+        body: requestBody,
+      });
+
+      // Verify it was called exactly once
+      expect(mockApi.makeRequest).toHaveBeenCalledTimes(1);
+    });
+
+    /**
+     * Tests that both file_url and file_blob can be provided simultaneously
+     */
+    it("should handle request with both file_url and file_blob", async () => {
+      const mockResponse = {
+        success: true,
+        urls: ["https://example.com/image.png"],
+        message: "Success"
+      };
+
+      vi.mocked(mockApi.makeRequest).mockResolvedValue(mockResponse);
+
+      const requestBody = {
+        file_url: "https://example.com/file.pdf",
+        file_blob: "base64data..."
+      };
+
+      const result = await cloudFiles.pdfToImages(requestBody);
+
+      expect(mockApi.makeRequest).toHaveBeenCalledWith("/files/pdf-to-images", {
+        method: "POST",
+        body: requestBody,
+      });
+
+      expect(result).toEqual(mockResponse);
+    });
+  });
+
+  describe("generatePresignedUploadUrl", () => {
+    /**
+     * Tests successful generation of presigned upload URL
+     * This matches the curl request structure provided
+     */
+    it("should successfully generate presigned upload URL", async () => {
+      const mockResponse = {
+        success: true,
+        signedUrl: "https://aui-cloud-attachments.5c52327048f352f85fb041947c406ab4.r2.cloudflarestorage.com/attachments/0204c5a7-cd09-470c-9488-96cf0be9db92.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=8698a7e98d990c6edd11fee3a9d0f3f0%2F20250606%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20250606T051813Z&X-Amz-Expires=900&X-Amz-Signature=b0d27e7bee6200eb1964ad1d7f4a8ad76db15a3d99bd4fb47ff4b0b08fee5ca5&X-Amz-SignedHeaders=content-length%3Bhost&x-amz-checksum-crc32=AAAAAA%3D%3D&x-amz-meta-original-filename=hello.pdf&x-amz-meta-project-id=proj_09369w56dnge&x-amz-meta-user-id=676767&x-amz-sdk-checksum-algorithm=CRC32&x-id=PutObject",
+        expiresAt: "2025-06-06T05:33:13.322Z",
+        publicUrl: "https://storage.assistant-api.com/attachments/0204c5a7-cd09-470c-9488-96cf0be9db92.pdf"
+      };
+
+      // Mock the API call to return our expected response
+      vi.mocked(mockApi.makeRequest).mockResolvedValue(mockResponse);
+
+      const requestBody = {
+        filename: "hello.pdf"
+      };
+
+      const result = await cloudFiles.generatePresignedUploadUrl(requestBody);
+
+      // Verify the API was called correctly
+      expect(mockApi.makeRequest).toHaveBeenCalledWith("/files/attachments/generate-presigned-upload-url", {
+        method: "POST",
+        body: requestBody,
+      });
+
+      // Verify the response structure
+      expect(result).toEqual(mockResponse);
+      expect(result.success).toBe(true);
+      expect(result.signedUrl).toContain("aui-cloud-attachments");
+      expect(result.signedUrl).toContain("X-Amz-Algorithm=AWS4-HMAC-SHA256");
+      expect(result.expiresAt).toBe("2025-06-06T05:33:13.322Z");
+      expect(result.publicUrl).toBe("https://storage.assistant-api.com/attachments/0204c5a7-cd09-470c-9488-96cf0be9db92.pdf");
+    });
+
+    /**
+     * Tests generation with different file types
+     */
+    it("should successfully generate presigned upload URL for different file types", async () => {
+      const mockResponse = {
+        success: true,
+        signedUrl: "https://aui-cloud-attachments.5c52327048f352f85fb041947c406ab4.r2.cloudflarestorage.com/attachments/test-image.png",
+        expiresAt: "2025-06-06T05:33:13.322Z",
+        publicUrl: "https://storage.assistant-api.com/attachments/test-image.png"
+      };
+
+      vi.mocked(mockApi.makeRequest).mockResolvedValue(mockResponse);
+
+      const requestBody = {
+        filename: "test-image.png"
+      };
+
+      const result = await cloudFiles.generatePresignedUploadUrl(requestBody);
+
+      expect(mockApi.makeRequest).toHaveBeenCalledWith("/files/attachments/generate-presigned-upload-url", {
+        method: "POST",
+        body: requestBody,
+      });
+
+      expect(result).toEqual(mockResponse);
+      expect(result.success).toBe(true);
+      expect(result.publicUrl).toContain("test-image.png");
+    });
+
+    /**
+     * Tests API error handling
+     */
+    it("should handle API errors gracefully", async () => {
+      const errorMessage = "Invalid filename";
+      vi.mocked(mockApi.makeRequest).mockRejectedValue(new Error(errorMessage));
+
+      const requestBody = {
+        filename: ""
+      };
+
+      await expect(cloudFiles.generatePresignedUploadUrl(requestBody)).rejects.toThrow(errorMessage);
+
+      expect(mockApi.makeRequest).toHaveBeenCalledWith("/files/attachments/generate-presigned-upload-url", {
+        method: "POST",
+        body: requestBody,
+      });
+    });
+
+    /**
+     * Tests handling of failed response
+     */
+    it("should handle failed upload URL generation response", async () => {
+      const mockResponse = {
+        success: false,
+        signedUrl: "",
+        expiresAt: "",
+        publicUrl: ""
+      };
+
+      vi.mocked(mockApi.makeRequest).mockResolvedValue(mockResponse);
+
+      const requestBody = {
+        filename: "invalid-file-type.exe"
+      };
+
+      const result = await cloudFiles.generatePresignedUploadUrl(requestBody);
+
+      expect(result.success).toBe(false);
+      expect(result.signedUrl).toBe("");
+      expect(result.publicUrl).toBe("");
+    });
+
+    /**
+     * Tests that the method sends the correct request headers and structure
+     */
+    it("should make request to correct endpoint with proper structure", async () => {
+      const mockResponse = {
+        success: true,
+        signedUrl: "https://example.com/signed-url",
+        expiresAt: "2025-06-06T05:33:13.322Z",
+        publicUrl: "https://example.com/public-url"
+      };
+
+      vi.mocked(mockApi.makeRequest).mockResolvedValue(mockResponse);
+
+      const requestBody = {
+        filename: "document.pdf"
+      };
+
+      await cloudFiles.generatePresignedUploadUrl(requestBody);
+
+      // Verify the endpoint and method are correct
+      expect(mockApi.makeRequest).toHaveBeenCalledWith("/files/attachments/generate-presigned-upload-url", {
+        method: "POST",
+        body: requestBody,
+      });
+
+      // Verify it was called exactly once
+      expect(mockApi.makeRequest).toHaveBeenCalledTimes(1);
+    });
+
+    /**
+     * Tests filename validation scenarios
+     */
+    it("should handle various filename formats", async () => {
+      const mockResponse = {
+        success: true,
+        signedUrl: "https://example.com/signed-url",
+        expiresAt: "2025-06-06T05:33:13.322Z",
+        publicUrl: "https://example.com/public-url"
+      };
+
+      vi.mocked(mockApi.makeRequest).mockResolvedValue(mockResponse);
+
+      // Test with filename containing spaces and special characters
+      const requestBody = {
+        filename: "my document (final version).pdf"
+      };
+
+      const result = await cloudFiles.generatePresignedUploadUrl(requestBody);
+
+      expect(mockApi.makeRequest).toHaveBeenCalledWith("/files/attachments/generate-presigned-upload-url", {
+        method: "POST",
+        body: requestBody,
+      });
+
+      expect(result).toEqual(mockResponse);
+    });
+  });
+
+  // Integration test that actually calls the real API
+  describe("Integration Tests", () => {
+    /**
+     * Integration test that actually calls the real API endpoint
+     * This test requires real API credentials to be set in environment variables:
+     * - AUI_API_KEY: Your API key (e.g., sk_aui_proj_...)
+     * - AUI_USER_ID: Your user ID  
+     * - AUI_WORKSPACE_ID: Your workspace ID
+     */
+    it.skipIf(!process.env.AUI_API_KEY || !process.env.AUI_USER_ID || !process.env.AUI_WORKSPACE_ID)(
+      "should actually convert PDF to images using real API", async () => {
+        // Unmock all modules for this test to use real implementations
+        vi.doUnmock("../cloud/AssistantCloudAPI");
+        vi.doUnmock("../cloud/AssistantCloudFiles");
+        vi.doUnmock("../cloud/AssistantCloud");
+        
+        // Clear all mocks and reload modules
+        vi.resetModules();
+        
+        // Import real modules
+        const { AssistantCloud: RealAssistantCloud } = await import("../cloud/AssistantCloud");
+
+        const realCloud = new RealAssistantCloud({
+          apiKey: process.env.AUI_API_KEY!,
+          userId: process.env.AUI_USER_ID!,
+          workspaceId: process.env.AUI_WORKSPACE_ID!,
+        });
+
+        const requestBody = {
+          file_url: "https://files.testfile.org/PDF/10MB-TESTFILE.ORG.pdf"
+        };
+
+        console.log("Making API call to convert PDF...");
+        const result = await realCloud.files.pdfToImages(requestBody);
+        console.log("API call result:", result);
+    
+        // Verify the response structure
+        expect(result).toHaveProperty("success");
+        expect(result).toHaveProperty("urls");
+        expect(result).toHaveProperty("message");
+
+        if (result.success) {
+          expect(Array.isArray(result.urls)).toBe(true);
+          expect(result.urls.length).toBeGreaterThan(0);
+          expect(typeof result.message).toBe("string");
+          
+          // Verify URLs are valid image URLs
+          result.urls.forEach(url => {
+            expect(url).toMatch(/^https:\/\/.+\.(png|jpg|jpeg)(\?.*)?$/i);
+          });
+        } else {
+          // If it fails, at least verify the error message is a string
+          expect(typeof result.message).toBe("string");
+          console.log("API call failed:", result.message);
+        }
+        
+        // Restore mocks after the test
+        vi.doMock("../cloud/AssistantCloudAPI");
+      },
+      60000 // 60 second timeout for real API calls
+    );
+
+    /**
+     * Integration test for generatePresignedUploadUrl that actually calls the real API endpoint
+     * This test requires real API credentials to be set in environment variables:
+     * - AUI_API_KEY: Your API key (e.g., sk_aui_proj_...)
+     * - AUI_USER_ID: Your user ID  
+     * - AUI_WORKSPACE_ID: Your workspace ID
+     */
+    it.skipIf(!process.env.AUI_API_KEY || !process.env.AUI_USER_ID || !process.env.AUI_WORKSPACE_ID)(
+      "should actually generate presigned upload URL using real API", async () => {
+        // Unmock all modules for this test to use real implementations
+        vi.doUnmock("../cloud/AssistantCloudAPI");
+        vi.doUnmock("../cloud/AssistantCloudFiles");
+        vi.doUnmock("../cloud/AssistantCloud");
+        
+        // Clear all mocks and reload modules
+        vi.resetModules();
+        
+        // Import real modules
+        const { AssistantCloud: RealAssistantCloud } = await import("../cloud/AssistantCloud");
+
+        const realCloud = new RealAssistantCloud({
+          apiKey: process.env.AUI_API_KEY!,
+          userId: process.env.AUI_USER_ID!,
+          workspaceId: process.env.AUI_WORKSPACE_ID!,
+        });
+
+        const requestBody = {
+          filename: "test-upload.pdf"
+        };
+
+        console.log("Making API call to generate presigned upload URL...");
+        const result = await realCloud.files.generatePresignedUploadUrl(requestBody);
+        console.log("API call result:", result);
+    
+        // Verify the response structure
+        expect(result).toHaveProperty("success");
+        expect(result).toHaveProperty("signedUrl");
+        expect(result).toHaveProperty("expiresAt");
+        expect(result).toHaveProperty("publicUrl");
+
+        if (result.success) {
+          expect(typeof result.signedUrl).toBe("string");
+          expect(typeof result.expiresAt).toBe("string");
+          expect(typeof result.publicUrl).toBe("string");
+          expect(result.signedUrl.length).toBeGreaterThan(0);
+          expect(result.publicUrl.length).toBeGreaterThan(0);
+          
+          // Verify URLs are valid HTTPS URLs
+          expect(result.signedUrl).toMatch(/^https:\/\/.+/);
+          expect(result.publicUrl).toMatch(/^https:\/\/.+/);
+          
+          // Verify the signed URL contains expected AWS signature parameters
+          expect(result.signedUrl).toContain("X-Amz-Algorithm");
+          expect(result.signedUrl).toContain("X-Amz-Signature");
+          
+          // Verify expiresAt is a valid ISO date string
+          expect(() => new Date(result.expiresAt)).not.toThrow();
+        } else {
+          console.log("API call failed - this may be expected for some test cases");
+        }
+        
+        // Restore mocks after the test
+        vi.doMock("../cloud/AssistantCloudAPI");
+      },
+      30000 // 30 second timeout for real API calls
+    );
+  });
+});