@epam/ai-dial-chat-hooks 1.3.0-dev.37 → 1.3.0-dev.372

package/project/project-mapping.js

@@ -0,0 +1,43 @@
+import { ProjectSource as e } from "@epam/ai-dial-chat-api-client";
+import { FilterTab as t, RequestStatus as n, getAttachmentTypeFromMime as r, inferMimeTypeFromPath as i } from "@epam/ai-dial-chat-shared";
+import { ProjectSource as a } from "@epam/ai-dial-projects";
+//#region src/project/project-mapping.ts
+var o = "", s = {
+	[e.Personal]: a.Personal,
+	[e.Shared]: a.Shared,
+	[e.Organization]: a.Organization
+}, c = (e) => s[e], l = {
+	[e.Personal]: t.MyChats,
+	[e.Shared]: t.Shared,
+	[e.Organization]: t.Organization
+}, u = (e) => l[e], d = (e) => ({
+	id: e.id,
+	name: e.name,
+	source: c(e.source),
+	parentPath: e.parentPath,
+	updatedAt: e.updatedAt ?? e.createdAt
+}), f = (e) => ({
+	name: e.name,
+	description: e.description,
+	instructions: e.instructions,
+	contextFiles: e.contextFiles.map(({ name: e }) => ({
+		name: e,
+		contentType: i(e) ?? o
+	}))
+}), p = (e) => e.contextFiles.map(({ name: e, size: t }) => {
+	let a = i(e) ?? o;
+	return {
+		id: `stored:${e}`,
+		name: e,
+		size: t,
+		contentType: a,
+		type: r(a),
+		status: n.Idle,
+		isStored: !0
+	};
+}), m = (e) => e.map(({ name: e }) => ({
+	name: e,
+	contentType: i(e) ?? o
+}));
+//#endregion
+export { m as mapProjectArtifactsToOutputs, f as mapProjectDetailsToViewModel, d as mapProjectDtoToItem, c as mapProjectSource, u as mapProjectSourceToFilterTab, p as mapStoredContextFiles };

package/project/project-refresh.d.ts

@@ -0,0 +1,12 @@
+/** How a silent refresh of one loaded project ended. */
+export declare enum ProjectRefreshOutcome {
+    /** The details were replaced with the fresh read. */
+    Updated = "updated",
+    /** The project no longer exists; the page should leave it. */
+    NotFound = "not-found",
+    /** The read failed; the loaded details are kept. */
+    Failed = "failed",
+    /** No project was loaded, or a newer refresh or an id change superseded this one. */
+    Skipped = "skipped"
+}
+//# sourceMappingURL=project-refresh.d.ts.map

package/project/project-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-refresh.d.ts","sourceRoot":"","sources":["../../src/project/project-refresh.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,oBAAY,qBAAqB;IAC/B,qDAAqD;IACrD,OAAO,YAAY;IACnB,8DAA8D;IAC9D,QAAQ,cAAc;IACtB,oDAAoD;IACpD,MAAM,WAAW;IACjB,qFAAqF;IACrF,OAAO,YAAY;CACpB"}

package/project/project-refresh.js

@@ -0,0 +1,6 @@
+//#region src/project/project-refresh.ts
+var e = /* @__PURE__ */ function(e) {
+	return e.Updated = "updated", e.NotFound = "not-found", e.Failed = "failed", e.Skipped = "skipped", e;
+}({});
+//#endregion
+export { e as ProjectRefreshOutcome };

package/project/project-viewed-marks.d.ts

@@ -0,0 +1,9 @@
+import { ProjectConversationItemDto } from '@epam/ai-dial-chat-api-client';
+/** Conversation id → its `updatedAt` when the viewer marked it viewed. */
+export type ViewedMarks = Map<string, number | undefined>;
+/**
+ * Returns whether a listed conversation shows as unread once the viewer's
+ * marks apply, and drops a mark that the listing's newer `updatedAt` outdated.
+ */
+export declare const applyViewedMark: (marks: ViewedMarks, { id, updatedAt, isUnread, }: Pick<ProjectConversationItemDto, "id" | "updatedAt" | "isUnread">) => boolean;
+//# sourceMappingURL=project-viewed-marks.d.ts.map

package/project/project-viewed-marks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-viewed-marks.d.ts","sourceRoot":"","sources":["../../src/project/project-viewed-marks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,WAAW,EAClB,8BAIG,IAAI,CAAC,0BAA0B,EAAE,IAAI,GAAG,WAAW,GAAG,UAAU,CAAC,KACnE,OAaF,CAAC"}

package/project/project-viewed-marks.js

@@ -0,0 +1,8 @@
+//#region src/project/project-viewed-marks.ts
+var e = (e, { id: t, updatedAt: n, isUnread: r }) => {
+	if (!e.has(t)) return r;
+	let i = e.get(t);
+	return n != null && i != null && n > i && (e.delete(t), r);
+};
+//#endregion
+export { e as applyViewedMark };

package/project/project-watch-stream.d.ts

@@ -0,0 +1,26 @@
+import { ProjectWatchEvent } from './project-events';
+import { ProjectsApiClient } from './projects-api-client';
+/** Delays before each reconnect attempt of a dropped watch stream. */
+export declare const WATCH_RECONNECT_DELAYS_MS: number[];
+/** One run of a projects watch stream, from its first open until it gives up or `signal` aborts. */
+export interface ProjectWatchRun {
+    /** The client's stream opener. */
+    watchProjects: NonNullable<ProjectsApiClient['watchProjects']>;
+    /** The project ids to watch. */
+    ids: string[];
+    /** Ends the run: the open stream is released and no reconnect fires. */
+    signal: AbortSignal;
+    /** Called with each well-formed event. */
+    onEvent: (event: ProjectWatchEvent) => void;
+    /** Called after a dropped stream was reopened, so the caller can catch up on the gap. */
+    onReconnected: () => void;
+    /** Called once when the watch cannot be opened or kept open, for the rest of the visit. */
+    onUnavailable: () => void;
+}
+/**
+ * Keeps a projects watch open: a stream that drops is reopened with a bounded
+ * backoff, and a watch whose first open fails (a Core without project events,
+ * a project no longer readable) or whose retries run out gives up.
+ */
+export declare const runProjectWatch: ({ watchProjects, ids, signal, onEvent, onReconnected, onUnavailable, }: ProjectWatchRun) => void;
+//# sourceMappingURL=project-watch-stream.d.ts.map

package/project/project-watch-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-watch-stream.d.ts","sourceRoot":"","sources":["../../src/project/project-watch-stream.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,sEAAsE;AACtE,eAAO,MAAM,yBAAyB,UAAkC,CAAC;AAEzE,oGAAoG;AACpG,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,aAAa,EAAE,WAAW,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC,CAAC;IAC/D,gCAAgC;IAChC,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,wEAAwE;IACxE,MAAM,EAAE,WAAW,CAAC;IACpB,0CAA0C;IAC1C,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC5C,yFAAyF;IACzF,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,2FAA2F;IAC3F,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,wEAO7B,eAAe,KAAG,IA2CpB,CAAC"}

package/project/project-watch-stream.js

@@ -0,0 +1,39 @@
+import { parseProjectWatchEvent as e } from "./project-events.js";
+import { readSseEvents as t } from "../shared/read-sse-events.js";
+//#region src/project/project-watch-stream.ts
+var n = [
+	1e3,
+	2e3,
+	4e3,
+	8e3,
+	16e3
+], r = ({ watchProjects: r, ids: i, signal: a, onEvent: o, onReconnected: s, onUnavailable: c }) => {
+	let l;
+	a.addEventListener("abort", () => clearTimeout(l), { once: !0 });
+	let u = (t) => {
+		let n = e(t);
+		return n != null && o(n), a.aborted;
+	}, d = (e) => {
+		let t = n[e];
+		t == null ? c() : l = setTimeout(() => {
+			f(e, !0);
+		}, t);
+	}, f = async (e, n) => {
+		let o;
+		try {
+			o = await r(i, a);
+		} catch {
+			if (a.aborted) return;
+			if (!n) {
+				c();
+				return;
+			}
+			d(e + 1);
+			return;
+		}
+		n && s(), await t(o, u), !a.aborted && d(0);
+	};
+	f(0, !1);
+};
+//#endregion
+export { n as WATCH_RECONNECT_DELAYS_MS, r as runProjectWatch };

package/project/projects-api-client.d.ts

@@ -0,0 +1,179 @@
+import { AttachmentDto, ConversationResponseDto, CreateConversationDto, CreateProjectResponseDto, ListProjectsResponseDto, ProjectArtifactListResponseDto, ProjectConversationListResponseDto, ProjectConversationTitlesResponseDto, ProjectDetailsDto, GenerateTitleResponseDto, RenameConversationResponseDto, UpdateProjectResponseDto } from '@epam/ai-dial-chat-api-client';
+import { RequestSkill } from '@epam/ai-dial-chat-shared';
+/** A generated-client `Raw` answer, of which only the native response is read. */
+interface RawApiResponse {
+    raw: Response;
+}
+/** Narrow configured generated-client (`ProjectsApi`) surface the project hooks require. */
+export interface ProjectsConfiguredClient {
+    listProjects: (options?: RequestInit) => Promise<ListProjectsResponseDto>;
+    getProject: (request: {
+        id: string;
+    }, options?: RequestInit) => Promise<ProjectDetailsDto>;
+    createProject: (request: {
+        name: string;
+        description?: string;
+        instructions?: string;
+        fileNames?: string;
+        files?: Blob[];
+    }, options?: RequestInit) => Promise<CreateProjectResponseDto>;
+    updateProject: (request: {
+        id: string;
+        ifMatch: string;
+        name: string;
+        description?: string;
+        instructions?: string;
+        fileNames?: string;
+        removedFileNames?: string;
+        files?: Blob[];
+    }, options?: RequestInit) => Promise<UpdateProjectResponseDto>;
+    deleteProject: (request: {
+        id: string;
+        ifMatch: string;
+    }) => Promise<void>;
+    downloadProjectRaw: (request: {
+        id: string;
+    }, options?: RequestInit) => Promise<RawApiResponse>;
+    downloadProjectFileRaw: (request: {
+        id: string;
+        fileName: string;
+    }, options?: RequestInit) => Promise<RawApiResponse>;
+    listProjectConversations: (request: {
+        id: string;
+    }, options?: RequestInit) => Promise<ProjectConversationListResponseDto>;
+    getProjectConversationTitles: (request: {
+        id: string;
+        projectConversationTitlesBodyDto: {
+            names: string[];
+        };
+    }, options?: RequestInit) => Promise<ProjectConversationTitlesResponseDto>;
+    listProjectArtifacts: (request: {
+        id: string;
+    }, options?: RequestInit) => Promise<ProjectArtifactListResponseDto>;
+    createProjectConversation: (request: {
+        id: string;
+        createConversationDto: CreateConversationDto;
+    }) => Promise<ConversationResponseDto>;
+    getProjectConversation: (request: {
+        id: string;
+        conversationName: string;
+    }, options?: RequestInit) => Promise<ConversationResponseDto>;
+    saveProjectConversation: (request: {
+        id: string;
+        conversationName: string;
+        saveConversationBodyDto: {
+            conversation: ConversationResponseDto;
+        };
+    }) => Promise<ConversationResponseDto>;
+    renameProjectConversation: (request: {
+        id: string;
+        conversationName: string;
+        renameConversationBodyDto: {
+            newTitle: string;
+        };
+    }) => Promise<RenameConversationResponseDto>;
+    generateProjectConversationTitle: (request: {
+        id: string;
+        conversationName: string;
+    }) => Promise<GenerateTitleResponseDto>;
+    deleteProjectConversation: (request: {
+        id: string;
+        conversationName: string;
+    }) => Promise<void>;
+    markProjectConversationViewed: (request: {
+        id: string;
+        conversationName: string;
+    }) => Promise<void>;
+    attachToProjectGenerationRaw: (request: {
+        id: string;
+        attachGenerationDto: {
+            path: string;
+        };
+    }, options?: RequestInit) => Promise<RawApiResponse>;
+    watchProjectsRaw: (request: {
+        watchProjectsBodyDto: {
+            ids: string[];
+        };
+    }, options?: RequestInit) => Promise<RawApiResponse>;
+}
+/** Text fields of a project create or edit request. */
+export interface ProjectFields {
+    /** Project name; also the last path segment of its id. */
+    name: string;
+    /** Plain-text description; when omitted, a save keeps the stored one. */
+    description?: string;
+    /** Markdown instructions, stored as the `PROJECT.md` body. */
+    instructions: string;
+}
+/** One project edit: the fields, the added files only, the stored files to drop and the loaded version. */
+export interface ProjectUpdateRequest {
+    /** The project's DIAL id. */
+    id: string;
+    /** The edited text fields. */
+    fields: ProjectFields;
+    /** Files added in this edit. */
+    newFiles: File[];
+    /** Names of the stored context files to remove. */
+    removedFileNames: string[];
+    /** The loaded project's `contentVersion`; a conversation written meanwhile does not change it. */
+    contentVersion: string;
+}
+/** The first message of a new top-level or project conversation. */
+export interface ConversationCreateRequest {
+    /** The first user message. */
+    firstMessage: string;
+    /** Model or application the conversation starts with. */
+    deploymentId: string;
+    /** Attachments of the first message. */
+    attachments?: AttachmentDto[];
+    /** Tool configuration of the first message. */
+    configurationValue?: Record<string, unknown>;
+    /** Form values of the first message. */
+    formValue?: Record<string, unknown>;
+    /** Skills requested with the first message. */
+    skills?: RequestSkill[];
+}
+/** App-agnostic project requests over a configured generated client. */
+export interface ProjectsApiClient {
+    listProjects: (signal?: AbortSignal) => Promise<ListProjectsResponseDto>;
+    getProject: (id: string, signal?: AbortSignal) => Promise<ProjectDetailsDto>;
+    createProject: (fields: ProjectFields, files: File[], signal?: AbortSignal) => Promise<CreateProjectResponseDto>;
+    updateProject: (request: ProjectUpdateRequest, signal?: AbortSignal) => Promise<UpdateProjectResponseDto>;
+    deleteProject: (id: string, contentVersion: string) => Promise<void>;
+    downloadProjectArchive: (id: string, signal?: AbortSignal) => Promise<Response>;
+    downloadProjectContextFile: (id: string, fileName: string, signal?: AbortSignal) => Promise<Response>;
+    /** Lists the files the agents saved under the project's `artifacts/` folder, newest first. */
+    listProjectArtifacts: (projectId: string, signal?: AbortSignal) => Promise<ProjectArtifactListResponseDto>;
+    listProjectConversations: (projectId: string, signal?: AbortSignal) => Promise<ProjectConversationListResponseDto>;
+    getProjectConversationTitles: (projectId: string, names: string[], signal?: AbortSignal) => Promise<ProjectConversationTitlesResponseDto>;
+    createProjectConversation: (projectId: string, request: ConversationCreateRequest) => Promise<ConversationResponseDto>;
+    getProjectConversation: (conversationId: string, signal?: AbortSignal) => Promise<ConversationResponseDto>;
+    saveProjectConversation: (conversationId: string, conversation: ConversationResponseDto) => Promise<ConversationResponseDto>;
+    renameProjectConversation: (conversationId: string, newTitle: string) => Promise<RenameConversationResponseDto>;
+    /** Suggests a title for the conversation without saving it. */
+    generateProjectConversationTitle: (conversationId: string) => Promise<GenerateTitleResponseDto>;
+    deleteProjectConversation: (conversationId: string) => Promise<void>;
+    /** Records that the caller has seen the conversation's current version; a host without it keeps no read state. */
+    markProjectConversationViewed?: (conversationId: string) => Promise<void>;
+    attachToProjectGeneration: (projectId: string, path: string, signal?: AbortSignal) => Promise<ReadableStream<Uint8Array>>;
+    /** Opens the SSE stream of changes to the given projects; a host without it gets no live updates. */
+    watchProjects?: (ids: string[], signal?: AbortSignal) => Promise<ReadableStream<Uint8Array>>;
+}
+/**
+ * Splits a project conversation id `projects/{bucket}/{projectPath…}/conversations/{name}`
+ * into the project id and the conversation file name; `null` for any other id.
+ */
+export declare const splitProjectConversationId: (conversationId: string) => {
+    projectId: string;
+    conversationName: string;
+} | null;
+/** The create-conversation body of a first message, the same for a top-level and a project conversation. */
+export declare const buildCreateConversationDto: ({ firstMessage, deploymentId, attachments, configurationValue, formValue, skills, }: ConversationCreateRequest) => CreateConversationDto;
+/**
+ * Composes the project requests over a configured generated `ProjectsApi`.
+ * File names travel as JSON fields, positionally paired with `files`,
+ * because the BFF never trusts a multipart part's own filename.
+ */
+export declare const createProjectsApiClient: (client: ProjectsConfiguredClient) => Required<ProjectsApiClient>;
+export {};
+//# sourceMappingURL=projects-api-client.d.ts.map

package/project/projects-api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects-api-client.d.ts","sourceRoot":"","sources":["../../src/project/projects-api-client.ts"],"names":[],"mappings":"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"}

package/project/projects-api-client.js

@@ -0,0 +1,90 @@
+//#region src/project/projects-api-client.ts
+var e = (e) => {
+	let t = e.split("/");
+	return t.length < 5 || t[0] !== "projects" || t[t.length - 2] !== "conversations" ? null : {
+		projectId: t.slice(0, -2).join("/"),
+		conversationName: t[t.length - 1]
+	};
+}, t = (t) => {
+	let n = e(t);
+	if (!n) throw Error("Not a project conversation id");
+	return {
+		id: n.projectId,
+		conversationName: n.conversationName
+	};
+}, n = (e) => e ? [{ signal: e }] : [], r = ({ firstMessage: e, deploymentId: t, attachments: n, configurationValue: r, formValue: i, skills: a }) => ({
+	firstMessage: e,
+	deploymentId: t,
+	...n?.length || r || i || a?.length ? { custom_content: {
+		...n?.length ? { attachments: n } : {},
+		...r ? { configuration_value: r } : {},
+		...i ? { form_value: i } : {},
+		...a?.length ? { skills: a } : {}
+	} } : {}
+}), i = (e) => ({
+	listProjects: (t) => e.listProjects(...n(t)),
+	getProject: (t, r) => e.getProject({ id: t }, ...n(r)),
+	createProject: ({ name: t, description: r, instructions: i }, a, o) => e.createProject({
+		name: t,
+		description: r,
+		instructions: i,
+		fileNames: JSON.stringify(a.map((e) => e.name)),
+		files: a
+	}, ...n(o)),
+	updateProject: ({ id: t, fields: r, newFiles: i, removedFileNames: a, contentVersion: o }, s) => e.updateProject({
+		id: t,
+		ifMatch: o,
+		name: r.name,
+		description: r.description,
+		instructions: r.instructions,
+		fileNames: JSON.stringify(i.map((e) => e.name)),
+		removedFileNames: JSON.stringify(a),
+		files: i
+	}, ...n(s)),
+	deleteProject: (t, n) => e.deleteProject({
+		id: t,
+		ifMatch: n
+	}),
+	downloadProjectArchive: async (t, r) => (await e.downloadProjectRaw({ id: t }, ...n(r))).raw,
+	downloadProjectContextFile: async (t, r, i) => (await e.downloadProjectFileRaw({
+		id: t,
+		fileName: r
+	}, ...n(i))).raw,
+	listProjectArtifacts: (t, r) => e.listProjectArtifacts({ id: t }, ...n(r)),
+	listProjectConversations: (t, r) => e.listProjectConversations({ id: t }, ...n(r)),
+	getProjectConversationTitles: (t, r, i) => e.getProjectConversationTitles({
+		id: t,
+		projectConversationTitlesBodyDto: { names: r }
+	}, ...n(i)),
+	createProjectConversation: (t, n) => e.createProjectConversation({
+		id: t,
+		createConversationDto: r(n)
+	}),
+	getProjectConversation: (r, i) => e.getProjectConversation(t(r), ...n(i)),
+	saveProjectConversation: (n, r) => e.saveProjectConversation({
+		...t(n),
+		saveConversationBodyDto: { conversation: r }
+	}),
+	renameProjectConversation: (n, r) => e.renameProjectConversation({
+		...t(n),
+		renameConversationBodyDto: { newTitle: r }
+	}),
+	generateProjectConversationTitle: (n) => e.generateProjectConversationTitle(t(n)),
+	deleteProjectConversation: (n) => e.deleteProjectConversation(t(n)),
+	markProjectConversationViewed: (n) => e.markProjectConversationViewed(t(n)),
+	attachToProjectGeneration: async (t, r, i) => {
+		let { raw: a } = await e.attachToProjectGenerationRaw({
+			id: t,
+			attachGenerationDto: { path: r }
+		}, ...n(i));
+		if (!a.body) throw Error("Attach endpoint returned no response body");
+		return a.body;
+	},
+	watchProjects: async (t, r) => {
+		let { raw: i } = await e.watchProjectsRaw({ watchProjectsBodyDto: { ids: t } }, ...n(r));
+		if (!i.body) throw Error("Watch endpoint returned no response body");
+		return i.body;
+	}
+});
+//#endregion
+export { r as buildCreateConversationDto, i as createProjectsApiClient, e as splitProjectConversationId };

package/project/use-pinned-project-chats.d.ts

@@ -0,0 +1,58 @@
+import { ProjectDetailsDto } from '@epam/ai-dial-chat-api-client';
+import { ProjectsApiClient } from './projects-api-client';
+/** Most chats listed under one pinned project. */
+export declare const PINNED_PROJECT_CHATS_LIMIT = 10;
+/** What `usePinnedProjectChats` needs from the host besides the ids. */
+export interface PinnedProjectChatsOptions {
+    /** No request is sent and `projects` is empty while `false`. */
+    enabled: boolean;
+    /** The project no longer exists (a watch `DELETE`, or `404` on a read). Called at most once per id. */
+    onProjectDeleted: (projectId: string) => void;
+}
+/** A chat listed under a pinned project. */
+export interface PinnedProjectChat {
+    /** The conversation's DIAL id. */
+    id: string;
+    /** Display title; the file-name title when its body could not be read. */
+    title: string;
+    /** The caller has not seen the conversation's current version. */
+    isUnread?: boolean;
+}
+/** A loaded pinned project and its newest chats. */
+export interface PinnedProjectChats {
+    /** The project's details as last read; `canEdit`, `canManage`, `contentVersion` and `conversationCount` feed the host's actions. */
+    project: ProjectDetailsDto;
+    /** At most `PINNED_PROJECT_CHATS_LIMIT` chats, newest first. */
+    chats: PinnedProjectChat[];
+    /** The project has more chats than `chats` holds. */
+    hasMore: boolean;
+}
+/** What `usePinnedProjectChats` returns. */
+export interface PinnedProjectChatsResult {
+    /** Loaded projects, in `projectIds` order; an id whose load failed is absent while it is retried. */
+    projects: PinnedProjectChats[];
+    /** True until every id of the current `projectIds` settled once. */
+    isLoading: boolean;
+    /** Clears a chat's unread state locally until a read reports a newer version. Sends no request. */
+    markViewed: (conversationId: string) => void;
+    /** Silently re-reads one loaded project, through the same per-project gate as a watch event. */
+    refresh: (projectId: string) => void;
+}
+/**
+ * Loads each pinned project's details and newest chats through the injected
+ * client, and keeps them current with one watch stream over every pinned
+ * project. A changed project is refreshed silently, one refresh at a time per
+ * project plus one trailing run; a deleted one is dropped and reported. A
+ * first load that fails with anything but a `404` is retried with a bounded
+ * backoff, and the project stays out of the watch until it loads. A dropped
+ * stream is reopened with a bounded backoff and followed by a refresh of every
+ * project; a watch that cannot be opened is not retried for the same projects.
+ * Requests are aborted on unmount, when `enabled` turns false, and for an id
+ * that leaves `projectIds`.
+ *
+ * @param client - Configured project requests, from `createProjectsApiClient`; it must be referentially stable, because a new object reloads.
+ * @param projectIds - The pinned project ids, in display order.
+ * @param options - Whether the tree is enabled and the delete callback; the callback is read at event time, so a new identity never resubscribes.
+ */
+export declare const usePinnedProjectChats: (client: Pick<ProjectsApiClient, "getProject" | "listProjectConversations" | "getProjectConversationTitles" | "watchProjects">, projectIds: string[], { enabled, onProjectDeleted }: PinnedProjectChatsOptions) => PinnedProjectChatsResult;
+//# sourceMappingURL=use-pinned-project-chats.d.ts.map

package/project/use-pinned-project-chats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-pinned-project-chats.d.ts","sourceRoot":"","sources":["../../src/project/use-pinned-project-chats.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAKvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,kDAAkD;AAClD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAW7C,wEAAwE;AACxE,MAAM,WAAW,yBAAyB;IACxC,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,uGAAuG;IACvG,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C;AAED,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,oIAAoI;IACpI,OAAO,EAAE,iBAAiB,CAAC;IAC3B,gEAAgE;IAChE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,wBAAwB;IACvC,qGAAqG;IACrG,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,oEAAoE;IACpE,SAAS,EAAE,OAAO,CAAC;IACnB,mGAAmG;IACnG,UAAU,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,gGAAgG;IAChG,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAiFD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,IAAI,CACV,iBAAiB,EACf,YAAY,GACZ,0BAA0B,GAC1B,8BAA8B,GAC9B,eAAe,CAClB,EACD,YAAY,MAAM,EAAE,EACpB,+BAA+B,yBAAyB,KACvD,wBAqXF,CAAC"}