@leaflow/sdk 0.198.0 → 0.200.0

package/dist/assistant/v1/generated/functions.d.ts

@@ -21,9 +21,12 @@
  *
  * Upload large files with /api/v1/uploads: read /api/v1/upload-configuration first, send exact-sized
  * parts, then complete the upload and send its attachment id in a message.
+ *
+ * Files uploaded that way are listed by search-attachments. Renaming or removing one does not change
+ * the conversations that already use it; downloading keeps working.
  * OpenAPI spec version: 2.0.0
  */
-import type { AnswerQuestionRequestBody, BindingCodeResponseBody, BindingResource, ChannelResource, ChannelWithSecretResponseBody, CheckSenderParams, CompleteUploadRequestBody, CreateChannelRequestBody, CreateFolderRequestBody, CreateTaskRequestBody, CreateThreadRequestBody, CreateThreadResponseBody, CreateUploadRequestBody, DecideToolCallsRequestBody, ErrorResponse, FolderListResponseBody, FolderResource, LengthAwarePageBindingResource, LengthAwarePageChannelResource, ListBindingsParams, ListChannelRejectionsParams, ListChannelsParams, ListTaskRunsParams, ListThreadItemsParams, ListThreadMessagesParams, ListThreadTurnsParams, LoginResource, MemoryListResponseBody, MoveFolderRequestBody, PlaceThreadRequestBody, PlatformListResponseBody, PutUploadPartHeaders, PutUploadPartParams, RejectionListResponseBody, ResumeThreadRequestBody, RevertRequestBody, RevertedCountResponseBody, RotateSecretRequestBody, SearchTasksRequestBody, SearchThreadsRequestBody, SendMessageRequestBody, SendMessageResponseBody, SenderCheckResource, SettingsResource, SkillEnabledRequestBody, SkillListResponseBody, SkillRequestBody, SkillResource, TaskListResponseBody, TaskResource, TaskRunListResponseBody, TaskRunResource, ThreadItemListResponseBody, ThreadItemResource, ThreadListResponseBody, ThreadMessageListResponseBody, ThreadResource, ThreadTurnListResponseBody, ToolResultRequestBody, TurnStartedResponseBody, UpdateChannelRequestBody, UpdateFolderRequestBody, UpdateSettingsRequestBody, UpdateTaskRequestBody, UpdateThreadRequestBody, UpdateUploadRequestBody, UploadAttachmentParams, UploadConfigurationResource, UploadListResponseBody, UploadPartResource, UploadResource, UploadedResource, VerifyCodeRequestBody, WebhookSecretResponseBody } from "./models.js";
+import type { AnswerQuestionRequestBody, AttachmentFileResource, AttachmentListResponseBody, BindingCodeResponseBody, BindingResource, ChannelResource, ChannelWithSecretResponseBody, CheckSenderParams, CompleteUploadRequestBody, CreateChannelRequestBody, CreateFolderRequestBody, CreateTaskRequestBody, CreateThreadRequestBody, CreateThreadResponseBody, CreateUploadRequestBody, DecideToolCallsRequestBody, ErrorResponse, FolderListResponseBody, FolderResource, LengthAwarePageBindingResource, LengthAwarePageChannelResource, ListBindingsParams, ListChannelRejectionsParams, ListChannelsParams, ListTaskRunsParams, ListThreadItemsParams, ListThreadMessagesParams, ListThreadTurnsParams, LoginResource, MemoryListResponseBody, MoveFolderRequestBody, PlaceThreadRequestBody, PlatformListResponseBody, PutUploadPartHeaders, PutUploadPartParams, RejectionListResponseBody, ResumeThreadRequestBody, RevertRequestBody, RevertedCountResponseBody, RotateSecretRequestBody, SearchAttachmentsRequestBody, SearchTasksRequestBody, SearchThreadsRequestBody, SendMessageRequestBody, SendMessageResponseBody, SenderCheckResource, SettingsResource, SkillEnabledRequestBody, SkillListResponseBody, SkillRequestBody, SkillResource, TaskListResponseBody, TaskResource, TaskRunListResponseBody, TaskRunResource, ThreadItemListResponseBody, ThreadItemResource, ThreadListResponseBody, ThreadMessageListResponseBody, ThreadResource, ThreadTurnListResponseBody, ToolResultRequestBody, TurnStartedResponseBody, UpdateAttachmentRequestBody, UpdateChannelRequestBody, UpdateFolderRequestBody, UpdateSettingsRequestBody, UpdateTaskRequestBody, UpdateThreadRequestBody, UpdateUploadRequestBody, UploadAttachmentParams, UploadConfigurationResource, UploadListResponseBody, UploadPartResource, UploadResource, UploadedResource, VerifyCodeRequestBody, WebhookSecretResponseBody } from "./models.js";
 export type HTTPStatusCode1xx = 100 | 101 | 102 | 103;
 export type HTTPStatusCode2xx = 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207;
 export type HTTPStatusCode3xx = 300 | 301 | 302 | 303 | 304 | 305 | 307 | 308;
@@ -970,6 +973,105 @@ export declare const getUploadAttachmentUrl: (params?: UploadAttachmentParams) =
  * @summary Upload a file
  */
 export declare const uploadAttachment: (uploadAttachmentBody: Blob, params?: UploadAttachmentParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<uploadAttachmentResponse>;
+export type searchAttachmentsResponse200 = {
+    data: AttachmentListResponseBody;
+    status: 200;
+};
+export type searchAttachmentsResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type searchAttachmentsResponseSuccess = searchAttachmentsResponse200 & {
+    headers: Headers;
+};
+export type searchAttachmentsResponseError = searchAttachmentsResponseDefault & {
+    headers: Headers;
+};
+export type searchAttachmentsResponse = searchAttachmentsResponseSuccess | searchAttachmentsResponseError;
+export declare const getSearchAttachmentsUrl: () => string;
+/**
+ * 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.
+ *
+ * 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
+ */
+export declare const searchAttachments: (searchAttachmentsRequestBody: SearchAttachmentsRequestBody, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<searchAttachmentsResponse>;
+export type getAttachmentResponse200 = {
+    data: AttachmentFileResource;
+    status: 200;
+};
+export type getAttachmentResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type getAttachmentResponseSuccess = getAttachmentResponse200 & {
+    headers: Headers;
+};
+export type getAttachmentResponseError = getAttachmentResponseDefault & {
+    headers: Headers;
+};
+export type getAttachmentResponse = getAttachmentResponseSuccess | getAttachmentResponseError;
+export declare const getGetAttachmentUrl: (attachment: string) => string;
+/**
+ * Metadata for one attachment. The bytes are at /api/v1/attachments/{attachment}: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.
+ * @summary Get a file
+ */
+export declare const getAttachment: (attachment: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getAttachmentResponse>;
+export type updateAttachmentResponse200 = {
+    data: AttachmentFileResource;
+    status: 200;
+};
+export type updateAttachmentResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type updateAttachmentResponseSuccess = updateAttachmentResponse200 & {
+    headers: Headers;
+};
+export type updateAttachmentResponseError = updateAttachmentResponseDefault & {
+    headers: Headers;
+};
+export type updateAttachmentResponse = updateAttachmentResponseSuccess | updateAttachmentResponseError;
+export declare const getUpdateAttachmentUrl: (attachment: string) => string;
+/**
+ * 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.
+ * @summary Rename a file
+ */
+export declare const updateAttachment: (attachment: string, updateAttachmentRequestBody: UpdateAttachmentRequestBody, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<updateAttachmentResponse>;
+export type deleteAttachmentResponse204 = {
+    data: void;
+    status: 204;
+};
+export type deleteAttachmentResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 204>;
+};
+export type deleteAttachmentResponseSuccess = deleteAttachmentResponse204 & {
+    headers: Headers;
+};
+export type deleteAttachmentResponseError = deleteAttachmentResponseDefault & {
+    headers: Headers;
+};
+export type deleteAttachmentResponse = deleteAttachmentResponseSuccess | deleteAttachmentResponseError;
+export declare const getDeleteAttachmentUrl: (attachment: string) => string;
+/**
+ * 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.
+ * @summary Remove a file from the library
+ */
+export declare const deleteAttachment: (attachment: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<deleteAttachmentResponse>;
 export type downloadAttachmentResponse200 = {
     data: Blob;
     status: 200;
@@ -987,7 +1089,7 @@ export type downloadAttachmentResponseError = downloadAttachmentResponseDefault
 export type downloadAttachmentResponse = downloadAttachmentResponseSuccess | downloadAttachmentResponseError;
 export declare const getDownloadAttachmentUrl: (attachment: string) => string;
 /**
- * Returns the original bytes for an attachment id. 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 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.
  *
  * 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.
  * @summary Download a file

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

@@ -1094,11 +1094,124 @@ export const uploadAttachment = async (uploadAttachmentBody, params, options, fe
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getDownloadAttachmentUrl = (attachment) => {
+export const getSearchAttachmentsUrl = () => {
+    return `https://assistant.leaflow.cloud/api/v1/attachments`;
+};
+/**
+ * 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.
+ *
+ * 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
+ */
+export const searchAttachments = async (searchAttachmentsRequestBody, 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)(getSearchAttachmentsUrl(), {
+        ...options,
+        method: "QUERY",
+        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
+        body: JSON.stringify(searchAttachmentsRequestBody),
+    });
+    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))}`;
 };
 /**
- * Returns the original bytes for an attachment id. 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.
+ * Metadata for one attachment. The bytes are at /api/v1/attachments/{attachment}: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.
+ * @summary Get a file
+ */
+export const getAttachment = async (attachment, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getGetAttachmentUrl(attachment), {
+        ...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 getUpdateAttachmentUrl = (attachment) => {
+    return `https://assistant.leaflow.cloud/api/v1/attachments/${encodeURIComponent(String(attachment))}`;
+};
+/**
+ * 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.
+ * @summary Rename a file
+ */
+export const updateAttachment = async (attachment, updateAttachmentRequestBody, 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)(getUpdateAttachmentUrl(attachment), {
+        ...options,
+        method: "PATCH",
+        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
+        body: JSON.stringify(updateAttachmentRequestBody),
+    });
+    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))}`;
+};
+/**
+ * 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.
+ * @summary Remove a file from the library
+ */
+export const deleteAttachment = async (attachment, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getDeleteAttachmentUrl(attachment), {
+        ...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 getDownloadAttachmentUrl = (attachment) => {
+    return `https://assistant.leaflow.cloud/api/v1/attachments/${encodeURIComponent(String(attachment))}: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.
  *
  * 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.
  * @summary Download a file

package/dist/assistant/v1/generated/models.d.ts

@@ -21,6 +21,9 @@
  *
  * Upload large files with /api/v1/uploads: read /api/v1/upload-configuration first, send exact-sized
  * parts, then complete the upload and send its attachment id in a message.
+ *
+ * Files uploaded that way are listed by search-attachments. Renaming or removing one does not change
+ * the conversations that already use it; downloading keeps working.
  * OpenAPI spec version: 2.0.0
  */
 export interface FieldViolation {
@@ -1519,6 +1522,105 @@ export interface UpdateSettingsRequestBody {
     defaultModelId?: string | null;
     defaultReasoningEffort?: ReasoningEffort | null;
 }
+/**
+ * Counts over everything the criteria match, ignoring `ids` and the cursor.
+ */
+export interface AttachmentCountsResource {
+    total: number;
+    totalBytes: number;
+}
+/**
+ * How the assistant will see this file.
+ */
+export type AttachmentFileResourceType = (typeof AttachmentFileResourceType)[keyof typeof AttachmentFileResourceType];
+export declare const AttachmentFileResourceType: {
+    readonly image: "image";
+    readonly text: "text";
+    readonly binary: "binary";
+};
+export interface AttachmentFileResource {
+    byteSize: number;
+    createdAt: string;
+    /**
+     * When this draft is cleared if no message ever references it. Null once a message uses it —
+     * a file that belongs to a conversation is kept as long as the conversation is.
+     * @nullable
+     */
+    draftExpiresAt: string | null;
+    filename: string;
+    /**
+     * Null unless type is image.
+     * @nullable
+     */
+    height: number | null;
+    id: string;
+    /** Detected at intake, not the Content-Type the client sent. */
+    mime: string;
+    /** How the assistant will see this file. */
+    type: AttachmentFileResourceType;
+    updatedAt: string;
+    /**
+     * Null unless type is image.
+     * @nullable
+     */
+    width: number | null;
+}
+export interface AttachmentListResponseBody {
+    attachments: AttachmentFileResource[];
+    /**
+     * Null on the last page.
+     * @nullable
+     */
+    nextCursor: string | null;
+    /** Null unless `include` asked for it. */
+    counts: AttachmentCountsResource | null;
+}
+/**
+ * How the assistant sees the file.
+ */
+export type SearchAttachmentsRequestBodyType = (typeof SearchAttachmentsRequestBodyType)[keyof typeof SearchAttachmentsRequestBodyType];
+export declare const SearchAttachmentsRequestBodyType: {
+    readonly image: "image";
+    readonly text: "text";
+    readonly binary: "binary";
+};
+export type SearchAttachmentsRequestBodyIncludeItem = (typeof SearchAttachmentsRequestBodyIncludeItem)[keyof typeof SearchAttachmentsRequestBodyIncludeItem];
+export declare const SearchAttachmentsRequestBodyIncludeItem: {
+    readonly counts: "counts";
+};
+export interface SearchAttachmentsRequestBody {
+    /**
+     * Read these attachments. Cannot be combined with cursor.
+     * @minItems 1
+     * @maxItems 200
+     */
+    ids?: string[];
+    /**
+     * Matches filenames, case-insensitively.
+     * @maxLength 100
+     */
+    q?: string;
+    /** How the assistant sees the file. */
+    type?: SearchAttachmentsRequestBodyType;
+    /** True for uploads no message references, false for the rest. */
+    draft?: boolean;
+    /** @maxLength 1024 */
+    cursor?: string;
+    /**
+     * @minimum 1
+     * @maximum 200
+     */
+    limit?: number;
+    /** Optional parts of the response. `counts` adds `counts`. */
+    include?: SearchAttachmentsRequestBodyIncludeItem[];
+}
+export interface UpdateAttachmentRequestBody {
+    /**
+     * @minLength 1
+     * @maxLength 255
+     */
+    filename: string;
+}
 /**
  * How the assistant will see this file.
  *

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

@@ -175,6 +175,19 @@ export const DefaultModelResourceSource = {
     user: "user",
     catalog: "catalog",
 };
+export const AttachmentFileResourceType = {
+    image: "image",
+    text: "text",
+    binary: "binary",
+};
+export const SearchAttachmentsRequestBodyType = {
+    image: "image",
+    text: "text",
+    binary: "binary",
+};
+export const SearchAttachmentsRequestBodyIncludeItem = {
+    counts: "counts",
+};
 export const UploadedResourceType = {
     image: "image",
     text: "text",

package/dist/assistant/v1/generated/schemas.zod.d.ts

@@ -21,6 +21,9 @@
  *
  * Upload large files with /api/v1/uploads: read /api/v1/upload-configuration first, send exact-sized
  * parts, then complete the upload and send its attachment id in a message.
+ *
+ * Files uploaded that way are listed by search-attachments. Renaming or removing one does not change
+ * the conversations that already use it; downloading keeps working.
  * OpenAPI spec version: 2.0.0
  */
 import * as zod from "zod";
@@ -645,7 +648,39 @@ export declare const UploadAttachmentQueryParams: zod.ZodObject<{
     filename: zod.ZodOptional<zod.ZodString>;
 }, zod.z.core.$strict>;
 /**
- * Returns the original bytes for an attachment id. 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.
+ * Metadata for one attachment. The bytes are at /api/v1/attachments/{attachment}: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.
+ * @summary Get a file
+ */
+export declare const GetAttachmentParams: zod.ZodObject<{
+    attachment: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * 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.
+ * @summary Rename a file
+ */
+export declare const UpdateAttachmentParams: zod.ZodObject<{
+    attachment: zod.ZodString;
+}, zod.z.core.$strict>;
+export declare const UpdateAttachmentBody: zod.ZodObject<{
+    filename: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * 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.
+ * @summary Remove a file from the library
+ */
+export declare const DeleteAttachmentParams: zod.ZodObject<{
+    attachment: zod.ZodString;
+}, zod.z.core.$strict>;
+/**
+ * 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.
  *
  * 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.
  * @summary Download a file

package/dist/assistant/v1/generated/schemas.zod.js

@@ -21,6 +21,9 @@
  *
  * Upload large files with /api/v1/uploads: read /api/v1/upload-configuration first, send exact-sized
  * parts, then complete the upload and send its attachment id in a message.
+ *
+ * Files uploaded that way are listed by search-attachments. Renaming or removing one does not change
+ * the conversations that already use it; downloading keeps working.
  * OpenAPI spec version: 2.0.0
  */
 import * as zod from "zod";
@@ -41,6 +44,7 @@ import { SendMessageRequestBody } from "./validators/sendMessageRequestBody.zod.
 import { SkillEnabledRequestBody } from "./validators/skillEnabledRequestBody.zod.js";
 import { SkillRequestBody } from "./validators/skillRequestBody.zod.js";
 import { ToolResultRequestBody } from "./validators/toolResultRequestBody.zod.js";
+import { UpdateAttachmentRequestBody } from "./validators/updateAttachmentRequestBody.zod.js";
 import { UpdateChannelRequestBody } from "./validators/updateChannelRequestBody.zod.js";
 import { UpdateFolderRequestBody } from "./validators/updateFolderRequestBody.zod.js";
 import { UpdateSettingsRequestBody } from "./validators/updateSettingsRequestBody.zod.js";
@@ -585,7 +589,37 @@ export const UploadAttachmentQueryParams = zod.strictObject({
         .describe("The name to show and to give the assistant. Images do not need one; anything else does, because the name is most of what says what the file is. Falls back to a generated name."),
 });
 /**
- * Returns the original bytes for an attachment id. 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.
+ * Metadata for one attachment. The bytes are at /api/v1/attachments/{attachment}: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.
+ * @summary Get a file
+ */
+export const GetAttachmentParams = zod.strictObject({
+    attachment: zod.string(),
+});
+/**
+ * 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.
+ * @summary Rename a file
+ */
+export const UpdateAttachmentParams = zod.strictObject({
+    attachment: zod.string(),
+});
+export const UpdateAttachmentBody = UpdateAttachmentRequestBody;
+/**
+ * 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.
+ * @summary Remove a file from the library
+ */
+export const DeleteAttachmentParams = zod.strictObject({
+    attachment: zod.string(),
+});
+/**
+ * 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.
  *
  * 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.
  * @summary Download a file

package/dist/assistant/v1/generated/validators/answerQuestionRequestBody.zod.d.ts

@@ -21,6 +21,9 @@
  *
  * Upload large files with /api/v1/uploads: read /api/v1/upload-configuration first, send exact-sized
  * parts, then complete the upload and send its attachment id in a message.
+ *
+ * Files uploaded that way are listed by search-attachments. Renaming or removing one does not change
+ * the conversations that already use it; downloading keeps working.
  * OpenAPI spec version: 2.0.0
  */
 import * as zod from "zod";

package/dist/assistant/v1/generated/validators/answerQuestionRequestBody.zod.js

@@ -21,6 +21,9 @@
  *
  * Upload large files with /api/v1/uploads: read /api/v1/upload-configuration first, send exact-sized
  * parts, then complete the upload and send its attachment id in a message.
+ *
+ * Files uploaded that way are listed by search-attachments. Renaming or removing one does not change
+ * the conversations that already use it; downloading keeps working.
  * OpenAPI spec version: 2.0.0
  */
 import * as zod from "zod";

package/dist/assistant/v1/generated/validators/approvalMode.zod.d.ts

@@ -21,6 +21,9 @@
  *
  * Upload large files with /api/v1/uploads: read /api/v1/upload-configuration first, send exact-sized
  * parts, then complete the upload and send its attachment id in a message.
+ *
+ * Files uploaded that way are listed by search-attachments. Renaming or removing one does not change
+ * the conversations that already use it; downloading keeps working.
  * OpenAPI spec version: 2.0.0
  */
 import * as zod from "zod";

package/dist/assistant/v1/generated/validators/approvalMode.zod.js

@@ -21,6 +21,9 @@
  *
  * Upload large files with /api/v1/uploads: read /api/v1/upload-configuration first, send exact-sized
  * parts, then complete the upload and send its attachment id in a message.
+ *
+ * Files uploaded that way are listed by search-attachments. Renaming or removing one does not change
+ * the conversations that already use it; downloading keeps working.
  * OpenAPI spec version: 2.0.0
  */
 import * as zod from "zod";

package/dist/assistant/v1/generated/validators/attachmentCountsResource.zod.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Assistant API
+ * Conversations with agents that operate the Leaflow platform, plus their folders, tasks, files and
+ * chat-app channels.
+ *
+ * A conversation is a thread. A person talks to the main thread; the agent in it can start subagents,
+ * which are threads too and run on their own: stopping the main thread does not stop them, and each
+ * subagent tells its parent when it ends. A thread runs in turns; each turn records the model and
+ * reasoning effort it used and its token usage.
+ *
+ * Models come from the Canopy catalogue. A new thread uses the model it names, the caller's default
+ * from /api/v1/settings, or the first catalogue model that can run an agent. Reasoning models take one
+ * of three efforts — low, medium or high — which are sent to the model unchanged.
+ *
+ * Read a thread's state with get-thread and its transcript with list-thread-items. Follow both live
+ * through EventBus by subscribing to assistant.thread.frame and assistant.resource.updated; after a
+ * reconnection or an assistant.workspace.invalidated message, read them again. list-thread-messages
+ * outlines the person's messages for navigating a long conversation.
+ *
+ * Upload large files with /api/v1/uploads: read /api/v1/upload-configuration first, send exact-sized
+ * parts, then complete the upload and send its attachment id in a message.
+ *
+ * Files uploaded that way are listed by search-attachments. Renaming or removing one does not change
+ * the conversations that already use it; downloading keeps working.
+ * OpenAPI spec version: 2.0.0
+ */
+import * as zod from "zod";
+export declare const AttachmentCountsResource: zod.ZodObject<{
+    total: zod.ZodInt;
+    totalBytes: zod.ZodInt;
+}, zod.z.core.$strict>;
+export type AttachmentCountsResource = zod.input<typeof AttachmentCountsResource>;
+export type AttachmentCountsResourceOutput = zod.output<typeof AttachmentCountsResource>;

package/dist/assistant/v1/generated/validators/attachmentCountsResource.zod.js

@@ -0,0 +1,35 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Assistant API
+ * Conversations with agents that operate the Leaflow platform, plus their folders, tasks, files and
+ * chat-app channels.
+ *
+ * A conversation is a thread. A person talks to the main thread; the agent in it can start subagents,
+ * which are threads too and run on their own: stopping the main thread does not stop them, and each
+ * subagent tells its parent when it ends. A thread runs in turns; each turn records the model and
+ * reasoning effort it used and its token usage.
+ *
+ * Models come from the Canopy catalogue. A new thread uses the model it names, the caller's default
+ * from /api/v1/settings, or the first catalogue model that can run an agent. Reasoning models take one
+ * of three efforts — low, medium or high — which are sent to the model unchanged.
+ *
+ * Read a thread's state with get-thread and its transcript with list-thread-items. Follow both live
+ * through EventBus by subscribing to assistant.thread.frame and assistant.resource.updated; after a
+ * reconnection or an assistant.workspace.invalidated message, read them again. list-thread-messages
+ * outlines the person's messages for navigating a long conversation.
+ *
+ * Upload large files with /api/v1/uploads: read /api/v1/upload-configuration first, send exact-sized
+ * parts, then complete the upload and send its attachment id in a message.
+ *
+ * Files uploaded that way are listed by search-attachments. Renaming or removing one does not change
+ * the conversations that already use it; downloading keeps working.
+ * OpenAPI spec version: 2.0.0
+ */
+import * as zod from "zod";
+export const AttachmentCountsResource = zod
+    .strictObject({
+    total: zod.int(),
+    totalBytes: zod.int(),
+})
+    .describe("Counts over everything the criteria match, ignoring `ids` and the cursor.");