@leaflow/sdk 0.210.0 → 0.211.0

package/dist/assistant/v1/generated/functions.js

@@ -1048,7 +1048,7 @@ export const updateSettings = async (updateSettingsRequestBody, options, fetchFn
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getUploadAttachmentUrl = (params) => {
+export const getUploadFileUrl = (params) => {
     const normalizedParams = new URLSearchParams();
     Object.entries(params || {}).forEach(([key, value]) => {
         if (value !== undefined) {
@@ -1057,18 +1057,18 @@ export const getUploadAttachmentUrl = (params) => {
     });
     const stringifiedParams = normalizedParams.toString();
     return stringifiedParams.length > 0
-        ? `https://assistant.leaflow.cloud/api/v1/attachments?${stringifiedParams}`
-        : `https://assistant.leaflow.cloud/api/v1/attachments`;
+        ? `https://assistant.leaflow.cloud/api/v1/files?${stringifiedParams}`
+        : `https://assistant.leaflow.cloud/api/v1/files`;
 };
 /**
- * The body is the file bytes themselves, not multipart, one file per request. The type is determined from the content, not from Content-Type or from the name. Put the returned id in attachmentIds when sending a message.
+ * The body is the file bytes themselves, not multipart, one file per request. The type is determined from the content, not from Content-Type or from the name. Put the returned id in a `file` part when sending a message.
  *
  * An upload that no message ever references is a draft, and drafts are collected — `draftExpiresAt` in the response says when this one goes. Sending a message with the id makes it permanent.
  *
  * The returned `type` says how the assistant will see it. An `image` is read directly, and only by models that accept image input. A small `text` file is placed inline in the message. A large `text` file, and anything `binary`, arrives as a reference the assistant reads on demand — for a binary that usually means downloading it onto one of the project's cloud instances.
  * @summary Upload a file
  */
-export const uploadAttachment = async (uploadAttachmentBody, params, options, fetchFn) => {
+export const uploadFile = async (uploadFileBody, params, options, fetchFn) => {
     const getHeaders = (h) => {
         if (!h)
             return {};
@@ -1084,31 +1084,33 @@ export const uploadAttachment = async (uploadAttachmentBody, params, options, fe
         }
         return headers;
     };
-    const res = await (fetchFn ?? fetch)(getUploadAttachmentUrl(params), {
+    const res = await (fetchFn ?? fetch)(getUploadFileUrl(params), {
         ...options,
         method: "POST",
         headers: { "Content-Type": "*/*", ...getHeaders(options?.headers) },
-        body: uploadAttachmentBody,
+        body: uploadFileBody,
     });
     const body = [204, 205, 304].includes(res.status) ? null : await res.text();
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getSearchAttachmentsUrl = () => {
-    return `https://assistant.leaflow.cloud/api/v1/attachments`;
+export const getSearchFilesUrl = () => {
+    return `https://assistant.leaflow.cloud/api/v1/files`;
 };
 /**
- * The caller's files in this project, most recently uploaded first. These are the files
- * uploaded while composing messages, plus uploads that no message has referenced yet.
+ * The caller's library in this project, most recently uploaded first: the files they attached to
+ * messages, plus uploads that no message has referenced yet. Files that tools produced and
+ * artifacts the assistant handed over are not listed here; artifacts are listed by
+ * list-artifacts.
  *
  * A file with no message referencing it is a draft: `draftExpiresAt` says when it is cleared.
  * Sending a message with the id makes it permanent and that field becomes null.
  *
  * Files removed from the library are not listed, but conversations that already use them keep
  * them and download-by-id still works.
- * @summary Search attachments
+ * @summary Search files
  */
-export const searchAttachments = async (searchAttachmentsRequestBody, options, fetchFn) => {
+export const searchFiles = async (searchFilesRequestBody, options, fetchFn) => {
     const getHeaders = (h) => {
         if (!h)
             return {};
@@ -1124,29 +1126,29 @@ export const searchAttachments = async (searchAttachmentsRequestBody, options, f
         }
         return headers;
     };
-    const res = await (fetchFn ?? fetch)(getSearchAttachmentsUrl(), {
+    const res = await (fetchFn ?? fetch)(getSearchFilesUrl(), {
         ...options,
         method: "QUERY",
         headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
-        body: JSON.stringify(searchAttachmentsRequestBody),
+        body: JSON.stringify(searchFilesRequestBody),
     });
     const body = [204, 205, 304].includes(res.status) ? null : await res.text();
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getGetAttachmentUrl = (attachment) => {
-    return `https://assistant.leaflow.cloud/api/v1/attachments/${encodeURIComponent(String(attachment))}`;
+export const getGetFileUrl = (file) => {
+    return `https://assistant.leaflow.cloud/api/v1/files/${encodeURIComponent(String(file))}`;
 };
 /**
- * Metadata for one attachment. The bytes are at /api/v1/attachments/{attachment}:download.
+ * Metadata for one file. The bytes are at /api/v1/files/{file}:download.
  *
- * Returns 404 when the attachment does not exist, does not belong to the current user, or was
- * removed from the library. Removed files stay readable through their conversations but are no
- * longer described here.
+ * Returns 404 when the file does not exist, does not belong to the current user, or was removed
+ * from the library. Removed files stay readable through their conversations but are no longer
+ * described here.
  * @summary Get a file
  */
-export const getAttachment = async (attachment, options, fetchFn) => {
-    const res = await (fetchFn ?? fetch)(getGetAttachmentUrl(attachment), {
+export const getFile = async (file, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getGetFileUrl(file), {
         ...options,
         method: "GET",
     });
@@ -1154,16 +1156,15 @@ export const getAttachment = async (attachment, options, fetchFn) => {
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getUpdateAttachmentUrl = (attachment) => {
-    return `https://assistant.leaflow.cloud/api/v1/attachments/${encodeURIComponent(String(attachment))}`;
+export const getUpdateFileUrl = (file) => {
+    return `https://assistant.leaflow.cloud/api/v1/files/${encodeURIComponent(String(file))}`;
 };
 /**
- * Changes the name shown in the library and given to the assistant. The bytes and the attachment
- * id do not change; conversations that already use it see the new name from their next request
- * on.
+ * Changes the name shown in the library and given to the assistant. The bytes and the file id do
+ * not change; conversations that already use it see the new name from their next request on.
  * @summary Rename a file
  */
-export const updateAttachment = async (attachment, updateAttachmentRequestBody, options, fetchFn) => {
+export const updateFile = async (file, updateFileRequestBody, options, fetchFn) => {
     const getHeaders = (h) => {
         if (!h)
             return {};
@@ -1179,27 +1180,27 @@ export const updateAttachment = async (attachment, updateAttachmentRequestBody,
         }
         return headers;
     };
-    const res = await (fetchFn ?? fetch)(getUpdateAttachmentUrl(attachment), {
+    const res = await (fetchFn ?? fetch)(getUpdateFileUrl(file), {
         ...options,
         method: "PATCH",
         headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
-        body: JSON.stringify(updateAttachmentRequestBody),
+        body: JSON.stringify(updateFileRequestBody),
     });
     const body = [204, 205, 304].includes(res.status) ? null : await res.text();
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getDeleteAttachmentUrl = (attachment) => {
-    return `https://assistant.leaflow.cloud/api/v1/attachments/${encodeURIComponent(String(attachment))}`;
+export const getDeleteFileUrl = (file) => {
+    return `https://assistant.leaflow.cloud/api/v1/files/${encodeURIComponent(String(file))}`;
 };
 /**
- * Hides the file from the library. Conversations that already use it keep it: the attachment
- * stays readable by id and keeps rendering in their history. Its bytes are released when the
- * project is deleted. A draft is cleared for good when its expiry passes. Idempotent.
+ * Hides the file from the library. Conversations that already use it keep it: the file stays
+ * readable by id and keeps rendering in their history. Its bytes are released when the project
+ * is deleted. A draft is cleared for good when its expiry passes. Idempotent.
  * @summary Remove a file from the library
  */
-export const deleteAttachment = async (attachment, options, fetchFn) => {
-    const res = await (fetchFn ?? fetch)(getDeleteAttachmentUrl(attachment), {
+export const deleteFile = async (file, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getDeleteFileUrl(file), {
         ...options,
         method: "DELETE",
     });
@@ -1207,17 +1208,17 @@ export const deleteAttachment = async (attachment, options, fetchFn) => {
     const data = body ? JSON.parse(body) : undefined;
     return { data, status: res.status, headers: res.headers };
 };
-export const getDownloadAttachmentUrl = (attachment) => {
-    return `https://assistant.leaflow.cloud/api/v1/attachments/${encodeURIComponent(String(attachment))}:download`;
+export const getDownloadFileUrl = (file) => {
+    return `https://assistant.leaflow.cloud/api/v1/files/${encodeURIComponent(String(file))}:download`;
 };
 /**
- * Returns the original bytes for an attachment id, including one removed from the library. The response carries long-lived cache headers because the content never changes. Returns 404 when the attachment does not exist or does not belong to the current user.
+ * Returns the original bytes of a file, including one removed from the library, a file a tool produced and an artifact version. The response carries long-lived cache headers because the content never changes. Returns 404 when the file does not exist or does not belong to the current user.
  *
- * Only an attachment whose `type` is `image` comes back with its own image type and is usable as the address of an `<img>`. Everything else is served as `application/octet-stream` with `Content-Disposition: attachment`, deliberately: an uploaded file is arbitrary bytes under a name its uploader chose, and serving it back inline would run it on this origin.
+ * Only a file whose `type` is `image` comes back with its own image type and is usable as the address of an `<img>`. Everything else is served as `application/octet-stream` with `Content-Disposition: attachment`, deliberately: a file is arbitrary bytes under a name chosen elsewhere, and serving it back inline would run it on this origin.
  * @summary Download a file
  */
-export const downloadAttachment = async (attachment, options, fetchFn) => {
-    const res = await (fetchFn ?? fetch)(getDownloadAttachmentUrl(attachment), {
+export const downloadFile = async (file, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getDownloadFileUrl(file), {
         ...options,
         method: "GET",
     });
@@ -1441,6 +1442,209 @@ export const putUploadPart = async (upload, part, putUploadPartBody, params, hea
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
+export const getListArtifactsUrl = (params) => {
+    const normalizedParams = new URLSearchParams();
+    Object.entries(params || {}).forEach(([key, value]) => {
+        if (value !== undefined) {
+            normalizedParams.append(key, value === null ? "null" : String(value));
+        }
+    });
+    const stringifiedParams = normalizedParams.toString();
+    return stringifiedParams.length > 0
+        ? `https://assistant.leaflow.cloud/api/v1/artifacts?${stringifiedParams}`
+        : `https://assistant.leaflow.cloud/api/v1/artifacts`;
+};
+/**
+ * The caller's artifacts in this project, most recently updated first. An artifact is a file the
+ * assistant handed over, kept under one title across its versions: a later version replaces what
+ * the person sees, and earlier versions stay readable.
+ *
+ * With `thread`, only artifacts that have a version created in that conversation are listed.
+ * @summary List artifacts
+ */
+export const listArtifacts = async (params, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getListArtifactsUrl(params), {
+        ...options,
+        method: "GET",
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : {};
+    return { data, status: res.status, headers: res.headers };
+};
+export const getCreateArtifactUrl = () => {
+    return `https://assistant.leaflow.cloud/api/v1/artifacts`;
+};
+/**
+ * Makes a file the first version of a new artifact. The file must belong to the caller in this
+ * project. Fails with 404 and code FILE_NOT_FOUND when it does not.
+ * @summary Create an artifact
+ */
+export const createArtifact = async (createArtifactRequestBody, options, fetchFn) => {
+    const getHeaders = (h) => {
+        if (!h)
+            return {};
+        if (h instanceof Headers)
+            return Object.fromEntries(h.entries());
+        if (Symbol.iterator in h) {
+            return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+        }
+        const headers = {};
+        for (const [name, value] of Object.entries(h)) {
+            if (value !== undefined)
+                headers[name] = value;
+        }
+        return headers;
+    };
+    const res = await (fetchFn ?? fetch)(getCreateArtifactUrl(), {
+        ...options,
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
+        body: JSON.stringify(createArtifactRequestBody),
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : {};
+    return { data, status: res.status, headers: res.headers };
+};
+export const getGetArtifactUrl = (artifact) => {
+    return `https://assistant.leaflow.cloud/api/v1/artifacts/${encodeURIComponent(String(artifact))}`;
+};
+/**
+ * @summary Get an artifact
+ */
+export const getArtifact = async (artifact, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getGetArtifactUrl(artifact), {
+        ...options,
+        method: "GET",
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : {};
+    return { data, status: res.status, headers: res.headers };
+};
+export const getUpdateArtifactUrl = (artifact) => {
+    return `https://assistant.leaflow.cloud/api/v1/artifacts/${encodeURIComponent(String(artifact))}`;
+};
+/**
+ * Changes the title shown for every version. The versions and their files do not change.
+ * @summary Rename an artifact
+ */
+export const updateArtifact = async (artifact, updateArtifactRequestBody, options, fetchFn) => {
+    const getHeaders = (h) => {
+        if (!h)
+            return {};
+        if (h instanceof Headers)
+            return Object.fromEntries(h.entries());
+        if (Symbol.iterator in h) {
+            return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+        }
+        const headers = {};
+        for (const [name, value] of Object.entries(h)) {
+            if (value !== undefined)
+                headers[name] = value;
+        }
+        return headers;
+    };
+    const res = await (fetchFn ?? fetch)(getUpdateArtifactUrl(artifact), {
+        ...options,
+        method: "PATCH",
+        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
+        body: JSON.stringify(updateArtifactRequestBody),
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : {};
+    return { data, status: res.status, headers: res.headers };
+};
+export const getDeleteArtifactUrl = (artifact) => {
+    return `https://assistant.leaflow.cloud/api/v1/artifacts/${encodeURIComponent(String(artifact))}`;
+};
+/**
+ * Removes the artifact and its versions from lists, and the assistant can no longer add versions
+ * to it. Conversations that showed a version keep showing it, and its file stays downloadable.
+ * Idempotent.
+ * @summary Delete an artifact
+ */
+export const deleteArtifact = async (artifact, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getDeleteArtifactUrl(artifact), {
+        ...options,
+        method: "DELETE",
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : undefined;
+    return { data, status: res.status, headers: res.headers };
+};
+export const getListArtifactVersionsUrl = (artifact, params) => {
+    const normalizedParams = new URLSearchParams();
+    Object.entries(params || {}).forEach(([key, value]) => {
+        if (value !== undefined) {
+            normalizedParams.append(key, value === null ? "null" : String(value));
+        }
+    });
+    const stringifiedParams = normalizedParams.toString();
+    return stringifiedParams.length > 0
+        ? `https://assistant.leaflow.cloud/api/v1/artifacts/${encodeURIComponent(String(artifact))}/versions?${stringifiedParams}`
+        : `https://assistant.leaflow.cloud/api/v1/artifacts/${encodeURIComponent(String(artifact))}/versions`;
+};
+/**
+ * The versions of an artifact, newest first.
+ * @summary List artifact versions
+ */
+export const listArtifactVersions = async (artifact, params, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getListArtifactVersionsUrl(artifact, params), {
+        ...options,
+        method: "GET",
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : {};
+    return { data, status: res.status, headers: res.headers };
+};
+export const getCreateArtifactVersionUrl = (artifact) => {
+    return `https://assistant.leaflow.cloud/api/v1/artifacts/${encodeURIComponent(String(artifact))}/versions`;
+};
+/**
+ * Makes a file the newest version of the artifact. The file must belong to the caller in this
+ * project. Fails with 404 and code FILE_NOT_FOUND when it does not.
+ * @summary Add a version
+ */
+export const createArtifactVersion = async (artifact, createArtifactVersionRequestBody, options, fetchFn) => {
+    const getHeaders = (h) => {
+        if (!h)
+            return {};
+        if (h instanceof Headers)
+            return Object.fromEntries(h.entries());
+        if (Symbol.iterator in h) {
+            return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+        }
+        const headers = {};
+        for (const [name, value] of Object.entries(h)) {
+            if (value !== undefined)
+                headers[name] = value;
+        }
+        return headers;
+    };
+    const res = await (fetchFn ?? fetch)(getCreateArtifactVersionUrl(artifact), {
+        ...options,
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
+        body: JSON.stringify(createArtifactVersionRequestBody),
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : {};
+    return { data, status: res.status, headers: res.headers };
+};
+export const getGetArtifactVersionUrl = (artifact, version) => {
+    return `https://assistant.leaflow.cloud/api/v1/artifacts/${encodeURIComponent(String(artifact))}/versions/${encodeURIComponent(String(version))}`;
+};
+/**
+ * @summary Get an artifact version
+ */
+export const getArtifactVersion = async (artifact, version, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getGetArtifactVersionUrl(artifact, version), {
+        ...options,
+        method: "GET",
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : {};
+    return { data, status: res.status, headers: res.headers };
+};
 export const getListMemoriesUrl = () => {
     return `https://assistant.leaflow.cloud/api/v1/memories`;
 };