@qilin-agent/client-ui-deliverables 0.0.0-stage → 3.1.3

package/lib/index.js

@@ -0,0 +1,290 @@
+import { remoteErrorOf } from "@qilin-agent/typert-protocol";
+//#region lib/types/changes.js
+/** Authenticated GET route serving one announced change summary while its Session lives. */
+const CHANGED_FILES_PATH = "/api/changes.summary";
+/** Authenticated GET route serving one listed file's turn-start and turn-end comparison while its Session lives. */
+const CHANGES_DIFF_PATH = "/api/changes.diff";
+/** Authenticated GET route serving the Session's whole changed-file list while its Session lives. */
+const CHANGES_SESSION_PATH = "/api/changes.session";
+/** Authenticated POST route for opening a changed file on the Host desktop. */
+const CHANGES_OPEN_PATH = "/api/changes.open";
+CHANGED_FILES_PATH.slice(1);
+CHANGES_DIFF_PATH.slice(1);
+CHANGES_SESSION_PATH.slice(1);
+CHANGES_OPEN_PATH.slice(1);
+//#endregion
+//#region lib/types/presented.js
+/** Authenticated POST route for opening a workspace file on the Host desktop. */
+const PRESENT_OPEN_PATH = "/api/present.open";
+/** Authenticated desktop availability and destination metadata. */
+const PRESENT_HOST_PATH = "/api/present.host";
+PRESENT_OPEN_PATH.slice(1);
+PRESENT_HOST_PATH.slice(1);
+/**
+* Validate a file declaration read from a Session log.
+* @param value - decoded durable data.
+* @returns whether the declaration contains a path and optional description.
+*/
+function isPresentedFile(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	const { path, description } = value;
+	return typeof path === "string" && path.trim().length > 0 && (description === void 0 || typeof description === "string");
+}
+/**
+* Validate a delivery event before reading its turn or file declarations.
+* @param value - decoded durable event data.
+* @returns whether the event identifies a turn, call, and file list.
+*/
+function isPresentedData(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	const { turn, callId, files } = value;
+	return typeof turn === "number" && Number.isSafeInteger(turn) && turn >= 1 && typeof callId === "string" && callId.length > 0 && Array.isArray(files);
+}
+//#endregion
+//#region lib/types/present-open.js
+/**
+* Register the deliverables routes inside Connection's authentication fence:
+* desktop metadata, change summaries and comparisons, declared-file actions,
+* and changed-file opening.
+* @param ctx - Session lookup, change summaries, native opener, and route lifetime.
+*/
+function registerPresentOpen(ctx) {
+	ctx.connection.fetch.register({
+		path: PRESENT_HOST_PATH,
+		methods: ["GET"],
+		requestBody: "buffered",
+		fetch: () => Promise.resolve(Response.json(ctx.sessionController.workspaceDesktop(), { headers: { "cache-control": "no-store" } }))
+	});
+	ctx.connection.fetch.register({
+		path: CHANGED_FILES_PATH,
+		methods: ["GET"],
+		requestBody: "buffered",
+		fetch: (request) => Promise.resolve(handleChangesSummary(ctx, request))
+	});
+	ctx.connection.fetch.register({
+		path: CHANGES_SESSION_PATH,
+		methods: ["GET"],
+		requestBody: "buffered",
+		fetch: (request) => Promise.resolve(handleChangesSession(ctx, request))
+	});
+	const lifetime = new AbortController();
+	const pending = /* @__PURE__ */ new Set();
+	ctx.effect(() => async () => {
+		lifetime.abort();
+		await Promise.allSettled(pending);
+	});
+	const routes = [
+		[
+			PRESENT_OPEN_PATH,
+			"POST",
+			handlePresentOpen
+		],
+		[
+			CHANGES_OPEN_PATH,
+			"POST",
+			handleChangesOpen
+		],
+		[
+			CHANGES_DIFF_PATH,
+			"GET",
+			handleChangesDiff
+		]
+	];
+	for (const [path, method, handler] of routes) ctx.connection.fetch.register({
+		path,
+		methods: [method],
+		requestBody: "buffered",
+		fetch: (request) => {
+			const task = handler(ctx, new Request(request, { signal: AbortSignal.any([request.signal, lifetime.signal]) }));
+			pending.add(task);
+			task.then(() => {
+				pending.delete(task);
+			}, () => {
+				pending.delete(task);
+			});
+			return task;
+		}
+	});
+}
+const NUMERIC = /^\d+$/;
+function coordinate(value) {
+	return value !== null && NUMERIC.test(value) && Number.isSafeInteger(Number(value)) ? Number(value) : void 0;
+}
+/** Translate lookup and filesystem failures into the not-found or failure status the browser retries from. */
+function failureStatus(error) {
+	const remote = remoteErrorOf(error);
+	return remote?.code === "session/not-found" || remote?.code === "workspace-file/not-found" || remote?.code === "workspace-file/not-regular-file" || error instanceof Error && "code" in error && (error.code === "SESSION_QUERY_SESSION_NOT_FOUND" || error.code === "SESSION_QUERY_EVENT_NOT_FOUND" || error.code === "ENOENT" || error.code === "ENOTDIR") ? 404 : 500;
+}
+/**
+* Read the addressed event once the Host desktop is known to be available.
+* @returns the event with its Session header, or the refusal to answer with.
+*/
+async function readTarget(ctx, request, id, seq) {
+	request.signal.throwIfAborted();
+	if (!ctx.sessionController.workspaceDesktop().available) return new Response("Host desktop unavailable.", { status: 409 });
+	return ctx.sessionQuery.readEvent({
+		sessionId: id,
+		seq,
+		before: 0,
+		after: 0
+	}, request.signal);
+}
+/**
+* Open one verified Host path. A file is verified through the Session
+* filesystem; a directory is verified by the Host filesystem mapping alone.
+* @returns the HTTP status to answer with.
+*/
+async function openVerified(ctx, request, path, action) {
+	const { fs } = ctx;
+	const mapped = fs.processPathFromHostPath(path);
+	if (mapped === void 0 || fs.processPath(await fs.resolve(mapped, { signal: request.signal })) !== path) return new Response("Path has no verified Host path.", { status: 422 });
+	request.signal.throwIfAborted();
+	await ctx.sessionController.openWorkspacePath({
+		path,
+		...action === "reveal" ? { action } : {}
+	}, request.signal);
+	return new Response(null, {
+		status: 204,
+		headers: { "cache-control": "no-store" }
+	});
+}
+async function handlePresentOpen(ctx, request) {
+	const query = new URL(request.url).searchParams;
+	const action = query.get("action") ?? "open";
+	if (action !== "open" && action !== "reveal") return new Response("Invalid file action.", { status: 400 });
+	const id = query.get("sessionId");
+	const seq = coordinate(query.get("seq"));
+	const index = coordinate(query.get("index"));
+	if (!id || seq === void 0 || index === void 0) return new Response("Invalid Presented file coordinates.", { status: 400 });
+	try {
+		const read = await readTarget(ctx, request, id, seq);
+		if (read instanceof Response) return read;
+		const { target, session } = read;
+		const file = target.type === "deliverables/presented" && isPresentedData(target.data) ? target.data.files[index] : void 0;
+		if (!isPresentedFile(file)) return new Response("Presented file not found in this Session result.", { status: 404 });
+		request.signal.throwIfAborted();
+		const { absolutePath: path } = await ctx.workspaceFiles.stat({
+			sessionId: id,
+			workspaceRoot: session.cwd ?? ctx.sandboxPolicy.workspaceRoot
+		}, file.path, request.signal);
+		return await openVerified(ctx, request, path, action);
+	} catch (error) {
+		request.signal.throwIfAborted();
+		return new Response("Presented file unavailable.", { status: failureStatus(error) });
+	}
+}
+/** The summary one `workspace/changes` event announced, without the Host working directory; 404 once the Host no longer serves it. */
+function handleChangesSummary(ctx, request) {
+	const query = new URL(request.url).searchParams;
+	const id = query.get("sessionId");
+	const seq = coordinate(query.get("seq"));
+	if (!id || seq === void 0) return new Response("Invalid change summary coordinates.", { status: 400 });
+	const summary = ctx.workspaceChanges.summary(id, seq);
+	if (summary === void 0) return new Response("Change summary unavailable.", { status: 404 });
+	const { turn, files, total, added, deleted } = summary;
+	return Response.json({
+		turn,
+		files,
+		total,
+		added,
+		deleted
+	}, { headers: { "cache-control": "no-store" } });
+}
+/** Every change the Session recorded, folded by path; 404 once the Host no longer holds its recorder. */
+function handleChangesSession(ctx, request) {
+	const id = new URL(request.url).searchParams.get("sessionId");
+	if (!id) return new Response("Invalid change session coordinates.", { status: 400 });
+	const changes = ctx.workspaceChanges.session(id);
+	if (changes === void 0) return new Response("Session changes unavailable.", { status: 404 });
+	const { files, total, added, deleted } = changes;
+	return Response.json({
+		files,
+		total,
+		added,
+		deleted
+	}, { headers: { "cache-control": "no-store" } });
+}
+/** A changed file's coordinates from a route query, or the 400 to answer with. */
+function changedFileCoordinates(request) {
+	const query = new URL(request.url).searchParams;
+	const id = query.get("sessionId");
+	const seq = coordinate(query.get("seq"));
+	const index = coordinate(query.get("index"));
+	if (!id || seq === void 0 || index === void 0) return new Response("Invalid changed file coordinates.", { status: 400 });
+	return {
+		id,
+		seq,
+		index
+	};
+}
+/** One listed file's comparison; 404 once the Host no longer serves the summary or the index names no file. */
+async function handleChangesDiff(ctx, request) {
+	const coordinates = changedFileCoordinates(request);
+	if (coordinates instanceof Response) return coordinates;
+	const { id, seq, index } = coordinates;
+	try {
+		const diff = await ctx.workspaceChanges.diff(id, seq, index, request.signal);
+		if (diff === void 0) return new Response("Change comparison unavailable.", { status: 404 });
+		return Response.json(diff, { headers: { "cache-control": "no-store" } });
+	} catch (error) {
+		request.signal.throwIfAborted();
+		return new Response("Change comparison unavailable.", { status: failureStatus(error) });
+	}
+}
+async function handleChangesOpen(ctx, request) {
+	const coordinates = changedFileCoordinates(request);
+	if (coordinates instanceof Response) return coordinates;
+	const { id, seq, index } = coordinates;
+	try {
+		request.signal.throwIfAborted();
+		if (!ctx.sessionController.workspaceDesktop().available) return new Response("Host desktop unavailable.", { status: 409 });
+		const changes = ctx.workspaceChanges.summary(id, seq);
+		if (changes === void 0) return new Response("Change summary unavailable.", { status: 404 });
+		const workspaceRoot = changes.cwd;
+		const file = changes.files[index];
+		if (file === void 0) return new Response("Changed file not found in this summary.", { status: 404 });
+		const { absolutePath: path } = await ctx.workspaceFiles.stat({
+			sessionId: id,
+			workspaceRoot
+		}, file.path, request.signal);
+		return await openVerified(ctx, request, path, "open");
+	} catch (error) {
+		request.signal.throwIfAborted();
+		return new Response("Changed file unavailable.", { status: failureStatus(error) });
+	}
+}
+//#endregion
+//#region lib/types/index.js
+/**
+* Deliverables plugin, node half. Registers Web file-reference guidance and
+* serves authenticated native opens of declared files. The browser
+* half ships via exports["./client"], discovered through the package.json
+* qilin.client declaration.
+*/
+/** Services required for file-reference guidance, change summaries, and authenticated native opens. */
+const inject = [
+	"systemPrompt",
+	"connection",
+	"sessionQuery",
+	"sessionController",
+	"workspaceFiles",
+	"fs",
+	"sandboxPolicy",
+	"workspaceChanges"
+];
+/** Static Web guidance for primary outputs and existing-file references. */
+const FILE_REFERENCE_PROMPT = "When you successfully create or modify files, mention the primary outputs in your final response. Use ![Description](<path/to/image.png>) when an image supports an explanation or comparison. Use [Description](<path/to/image.png>) when referring to an image or listing files. Enclose Markdown file destinations in angle brackets, especially paths containing spaces. Outside commands, configuration expressions, and code blocks, link every mention of an existing file, including repeats and tables, to its full path relative to the working directory or absolute; append #L24 or #L24-L30 to the target for known lines. Use the filename or a clear alias as the label, adding only enough parent directories to distinguish files; keep full paths out of labels. Default to the name alone; when precise locations matter, append :24 or :24–30, with no # or L in the line suffix.";
+/**
+* Register Web file-reference guidance and native opens for declared files.
+* @param ctx - host context carrying the system-prompt registry.
+*/
+function apply(ctx) {
+	registerPresentOpen(ctx);
+	ctx.systemPrompt.section({
+		name: "ui:deliverable-file-references",
+		order: ctx.systemPrompt.getSectionOrder("DELIVERABLE_FILE_REFERENCES"),
+		text: FILE_REFERENCE_PROMPT
+	});
+}
+//#endregion
+export { apply, inject };

package/lib/types/changes.d.ts

@@ -0,0 +1,122 @@
+/** Validate workspace-change records that cross the Host routes and address their summary, comparison, and native-open actions. */
+import type { SessionId } from '@qilin-agent/session/types';
+import type { WorkspaceChangedFile, WorkspaceChangesSummary, WorkspaceFileDiff, WorkspaceSessionChangedFile, WorkspaceSessionChanges } from '@qilin-agent/workspace-changes/types';
+/** Authenticated GET route serving one announced change summary while its Session lives. */
+export declare const CHANGED_FILES_PATH = "/api/changes.summary";
+/** Authenticated GET route serving one listed file's turn-start and turn-end comparison while its Session lives. */
+export declare const CHANGES_DIFF_PATH = "/api/changes.diff";
+/** Authenticated GET route serving the Session's whole changed-file list while its Session lives. */
+export declare const CHANGES_SESSION_PATH = "/api/changes.session";
+/** Authenticated POST route for opening a changed file on the Host desktop. */
+export declare const CHANGES_OPEN_PATH = "/api/changes.open";
+/**
+ * Browser-relative form of {@link CHANGED_FILES_PATH}; see
+ * .agents/notes/implemented/architecture/2026-09-14-web-document-relative-app-routes.md.
+ */
+export declare const CHANGED_FILES_ROUTE: string;
+/** Browser-relative form of {@link CHANGES_DIFF_PATH}. */
+export declare const CHANGES_DIFF_ROUTE: string;
+/** Browser-relative form of {@link CHANGES_SESSION_PATH}. */
+export declare const CHANGES_SESSION_ROUTE: string;
+/** Browser-relative form of {@link CHANGES_OPEN_PATH}. */
+export declare const CHANGES_OPEN_ROUTE: string;
+/** Resource-address prefix of a turn's review tab in the right Sidebar. */
+export declare const CHANGES_REVIEW_ADDRESS = "qilin-resource://changes-review/session/";
+/** The summary fields the route serves; the Host keeps the working directory and snapshot ids to itself. */
+export type ChangesSummary = Pick<WorkspaceChangesSummary, 'turn' | 'files' | 'total' | 'added' | 'deleted'>;
+/**
+ * The comparison the route serves, as the Host computed it.
+ */
+export type ChangesDiff = WorkspaceFileDiff;
+/** One file the Session changed, as the session route serves it. */
+export type ChangesSessionFile = WorkspaceSessionChangedFile;
+/** Every file change the Session recorded, folded by path across its turns. */
+export type ChangesSession = Pick<WorkspaceSessionChanges, 'files' | 'total' | 'added' | 'deleted'>;
+/** Coordinates of one turn's review: the viewed Session, the announcing event, and the turn it summarized. */
+export interface ChangesReviewCoordinates {
+    sessionId: SessionId;
+    seq: number;
+    /** The summarized turn, carried for the tab title. */
+    turn: number;
+}
+/**
+ * Validate one changed-file record read from the summary route.
+ * @param value - decoded JSON.
+ * @returns whether the record carries a path, a display path, and line counts.
+ */
+export declare function isChangedFile(value: unknown): value is WorkspaceChangedFile;
+/**
+ * Validate a summary read from the summary route.
+ * @param value - decoded JSON.
+ * @returns whether the value identifies a turn, a complete file list, the total count, and the line totals.
+ */
+export declare function isChangesSummary(value: unknown): value is ChangesSummary;
+/**
+ * Validate a comparison read from the comparison route.
+ * @param value - decoded JSON.
+ * @returns whether the value is a text comparison with well-formed hunks, or a binary or oversized refusal.
+ */
+export declare function isChangesDiff(value: unknown): value is ChangesDiff;
+/**
+ * Validate the `workspace/changes` event data read from a Session log.
+ * @param value - decoded durable event data.
+ * @returns whether the event names a turn.
+ */
+export declare function isChangesEvent(value: unknown): value is {
+    turn: number;
+};
+/**
+ * Build authenticated coordinates for the summary one `workspace/changes` event announced.
+ * @param sessionId - owning Session.
+ * @param seq - event sequence.
+ * @returns document-relative summary route.
+ */
+export declare function changesSummaryUrl(sessionId: SessionId, seq: number): string;
+/**
+ * Validate one folded session changed-file record read from the session route.
+ * @param value - decoded JSON.
+ * @returns whether the record carries a path, display, per-file counts, and its latest coordinates.
+ */
+export declare function isSessionChangedFile(value: unknown): value is WorkspaceSessionChangedFile;
+/**
+ * Validate the Session's whole changed-file list read from the session route.
+ * @param value - decoded JSON.
+ * @returns whether the list carries consistent totals and every record validates.
+ */
+export declare function isChangesSession(value: unknown): value is ChangesSession;
+/**
+ * Build authenticated coordinates for the Session's whole changed-file list.
+ * @param sessionId - owning Session.
+ * @returns document-relative session route.
+ */
+export declare function changesSessionUrl(sessionId: SessionId): string;
+/**
+ * Build authenticated coordinates for one listed file's comparison.
+ * @param sessionId - owning Session.
+ * @param seq - workspace/changes event sequence.
+ * @param index - original index in the summary's files array.
+ * @returns document-relative comparison route.
+ */
+export declare function changesDiffUrl(sessionId: SessionId, seq: number, index: number): string;
+/**
+ * Build authenticated coordinates for a changed file's native open.
+ * @param sessionId - owning Session.
+ * @param seq - workspace/changes event sequence.
+ * @param index - original index in the summary's files array.
+ * @returns document-relative action route.
+ */
+export declare function changedFileUrl(sessionId: SessionId, seq: number, index: number): string;
+/**
+ * The right-Sidebar address of one turn's review. The Session and the event
+ * sequence identify the content; the turn rides along for the tab title.
+ * @param coordinates - viewed Session, announcing event, and turn.
+ * @returns a `qilin-resource://changes-review/session/…` address.
+ */
+export declare function changesReviewAddress(coordinates: ChangesReviewCoordinates): string;
+/**
+ * Read the coordinates back out of a review address.
+ * @param address - a resource address.
+ * @returns the coordinates, or undefined for any other address.
+ */
+export declare function parseChangesReviewAddress(address: string): ChangesReviewCoordinates | undefined;
+//# sourceMappingURL=changes.d.ts.map

package/lib/types/client/ChangedFiles.d.ts

@@ -0,0 +1,19 @@
+import type { PropsLocale } from '@qilin-agent/client-ui-slots';
+import type { ChangesSummary } from '../changes.ts';
+import type { NS } from './locales.ts';
+/**
+ * Render one turn's changed files. The header opens the turn's review in the
+ * right Sidebar on its first file; each row opens it on that row's file.
+ * @param props - the recorded summary, the review opener, and localized copy.
+ * @returns the card.
+ */
+export declare function ChangedFiles({ changes, cwd, openReview, t }: {
+    /** The served summary with the sequence of the event that announced it. */
+    changes: Pick<ChangesSummary, 'files' | 'total' | 'added' | 'deleted'> & {
+        seq: number;
+    };
+    cwd: string | undefined;
+    /** Open the turn's review on the file at an original summary index. */
+    openReview: (index: number) => void;
+} & PropsLocale<typeof NS>): import("react").JSX.Element;
+//# sourceMappingURL=ChangedFiles.d.ts.map

package/lib/types/client/Deliverables.d.ts

@@ -0,0 +1,50 @@
+import type { TurnTailOwnerProps } from '@qilin-agent/client-ui-chat/client';
+import type { GlobalStandardProps, InjectFace, PropsLocale, PropsRuntime, SessionStandardProps } from '@qilin-agent/client-ui-slots';
+import type { ObservableSnapshot } from '@qilin-agent/client-store';
+import type { PresentedOpenController } from './present-open.ts';
+import type { ChangesSummaryStore } from './changes-summary.ts';
+import { type ChangesTurnData, type PresentedPath } from './turn-deliverables.ts';
+import type { NS } from './locales.ts';
+import { type ChangesReviewCoordinates } from '../changes.ts';
+interface DeliverablesMatch {
+    changes: ChangesTurnData | null;
+    presented: readonly PresentedPath[];
+}
+/** Summary reads, native-open callbacks, and shared gesture status supplied by the plugin. */
+export interface DeliverablesInjected {
+    hooks: {
+        presentedOpen: ObservableSnapshot<ReturnType<PresentedOpenController['state']['getSnapshot']>>;
+        presentedHost: ObservableSnapshot<ReturnType<PresentedOpenController['host']['getSnapshot']>>;
+        changesSummary: ObservableSnapshot<ReturnType<ChangesSummaryStore['state']['getSnapshot']>>;
+    };
+    reloadPresentedHost: PresentedOpenController['loadHost'];
+    loadChangesSummary: ChangesSummaryStore['load'];
+    openPresented: PresentedOpenController['open'];
+    openChanged: PresentedOpenController['openChanged'];
+    /** Open one turn's review in the right Sidebar on the file at an index. */
+    openChangesReview: (coordinates: ChangesReviewCoordinates, index: number) => void;
+}
+/**
+ * Claim turns with a change announcement or declared files.
+ * @param owner - closing turn.
+ * @returns matched announcement and deliveries, or null for a turn with neither.
+ */
+export declare function selectDeliverables(owner: TurnTailOwnerProps): DeliverablesMatch | null;
+/**
+ * Contribute file deliveries alongside other completed-Turn artifacts.
+ * @param props - closing Turn, file actions, and localized copy.
+ * @returns file rows, or null when the Turn declares none.
+ */
+export declare function DeliverablesTail(props: PropsRuntime<'conversation.chat.turnTail'> & PropsLocale<typeof NS> & InjectFace<DeliverablesInjected>): import("react").JSX.Element | null;
+/**
+ * Render the changed-files card, once the Host has served the announced
+ * summary and it lists a file, and default-application buttons for declared
+ * files. A summary the Host no longer serves leaves no card.
+ * @param props - matched announcement and files, workspace opener, and localized copy.
+ * @returns the closing turn's file rows.
+ */
+export declare function Deliverables({ matched, openFile, t, sessionId, useSessions, openPresented, openChangesReview, usePresentedOpen, usePresentedHost, useChangesSummary, reloadPresentedHost, loadChangesSummary, }: Pick<TurnTailOwnerProps, 'openFile'> & {
+    matched: DeliverablesMatch;
+} & PropsLocale<typeof NS> & Pick<SessionStandardProps, 'sessionId'> & Pick<GlobalStandardProps, 'useSessions'> & InjectFace<DeliverablesInjected>): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=Deliverables.d.ts.map

package/lib/types/client/PresentRow.d.ts

@@ -0,0 +1,12 @@
+import type { ToolCallViewProps } from '@qilin-agent/client-ui-tool/client';
+import type { PropsLocale } from '@qilin-agent/client-ui-slots';
+import type { NS } from './locales.ts';
+type PresentRowProps = ToolCallViewProps & PropsLocale<typeof NS>;
+/**
+ * Render a present call using its recorded arguments and result.
+ * @param props - tool call and localized status copy.
+ * @returns a status row with a result disclosure.
+ */
+export declare function PresentRow(props: PresentRowProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=PresentRow.d.ts.map

package/lib/types/client/PresentedFileCard.d.ts

@@ -0,0 +1,19 @@
+import type { PropsLocale } from '@qilin-agent/client-ui-slots';
+import type { PresentedAction, PresentedHost } from '../presented.ts';
+import type { PresentedOpenPhase } from './present-open.ts';
+import { type PresentedPath } from './turn-deliverables.ts';
+import type { NS } from './locales.ts';
+/**
+ * Render independent file actions without nesting buttons inside a clickable card.
+ * @param props - durable file metadata, Sidebar preview, Host capabilities, gesture status, and localized copy.
+ * @returns the file card and its anchored action menu.
+ */
+export declare function PresentedFileCard({ file, cwd, phase, host, onPreview, onAction, t }: {
+    file: PresentedPath;
+    cwd: string | undefined;
+    phase: PresentedOpenPhase | undefined;
+    host: PresentedHost | null;
+    onPreview: () => void;
+    onAction: (action: PresentedAction) => void;
+} & PropsLocale<typeof NS>): import("react").JSX.Element;
+//# sourceMappingURL=PresentedFileCard.d.ts.map

package/lib/types/client/ReviewTab.d.ts

@@ -0,0 +1,77 @@
+import type { ReactNode } from 'react';
+import type { InjectFace, PropsLocale, PropsRuntime, PropsStore } from '@qilin-agent/client-ui-slots';
+import type { ObservableSnapshot } from '@qilin-agent/client-store';
+import type { WorkspaceDiffHunk } from '@qilin-agent/workspace-changes/types';
+import type { ChangesDiffStore } from './changes-diff.ts';
+import type { ChangesSummaryStore } from './changes-summary.ts';
+import type { PresentedOpenController } from './present-open.ts';
+import type { createReviewStore } from './review-store.ts';
+import type { NS } from './locales.ts';
+/** Lines drawn before the tab stops; a coarse comparison of a file near the byte cap would otherwise draw every line. */
+export declare const MAX_RENDERED_LINES = 5000;
+/** Summary and comparison reads, desktop metadata, and the native open supplied by the plugin. */
+export interface ReviewInjected {
+    hooks: {
+        changesSummary: ObservableSnapshot<ReturnType<ChangesSummaryStore['state']['getSnapshot']>>;
+        changesDiff: ObservableSnapshot<ReturnType<ChangesDiffStore['state']['getSnapshot']>>;
+        presentedOpen: ObservableSnapshot<ReturnType<PresentedOpenController['state']['getSnapshot']>>;
+        presentedHost: ObservableSnapshot<ReturnType<PresentedOpenController['host']['getSnapshot']>>;
+    };
+    loadChangesSummary: ChangesSummaryStore['load'];
+    loadChangesDiff: ChangesDiffStore['load'];
+    reloadPresentedHost: PresentedOpenController['loadHost'];
+    openChanged: PresentedOpenController['openChanged'];
+}
+/** The body's composed props: the tab it draws, its store, its injected face, and its copy. */
+export type ReviewTabProps = PropsRuntime<'sidebar.right.pane.tab'> & PropsStore<ReturnType<typeof createReviewStore>> & InjectFace<ReviewInjected> & PropsLocale<typeof NS>;
+/** One drawn line of a hunk with its line numbers on each side. */
+export interface DiffRow {
+    kind: 'add' | 'del' | 'context';
+    old: number | undefined;
+    new: number | undefined;
+    text: string;
+}
+/** One side-by-side row: the old side, the new side, or both. */
+export interface SplitRow {
+    left?: {
+        no: number;
+        text: string;
+        kind: 'del' | 'context';
+    };
+    right?: {
+        no: number;
+        text: string;
+        kind: 'add' | 'context';
+    };
+}
+/**
+ * Number a hunk's lines: context lines count on both sides, deletions on the
+ * old side, additions on the new side.
+ * @param hunk - a served hunk.
+ * @returns the rows in order.
+ */
+export declare function hunkRows(hunk: WorkspaceDiffHunk): DiffRow[];
+/**
+ * Pair a hunk's lines for the side-by-side view: each run of deletions is
+ * aligned with the run of additions that follows it, row by row, and context
+ * lines sit on both sides.
+ * @param hunk - a served hunk.
+ * @returns the rows in order.
+ */
+export declare function splitRows(hunk: WorkspaceDiffHunk): SplitRow[];
+/**
+ * The hunks to draw, cut at {@link MAX_RENDERED_LINES} lines in total.
+ * @param hunks - served hunks.
+ * @returns the hunks with the last one shortened as needed, and whether anything was cut.
+ */
+export declare function renderedHunks(hunks: readonly WorkspaceDiffHunk[]): {
+    hunks: WorkspaceDiffHunk[];
+    truncated: boolean;
+};
+/**
+ * The review type's body, registered under `sidebar.right.pane.tab` as `changes-review`.
+ * @param props - composed slot props.
+ * @returns the selected file's comparison behind the file selector, or the state that stands in for it.
+ */
+export declare function ReviewTab({ useTabInfo, sessionId, useSessions, useStore, actions, useChangesSummary, useChangesDiff, usePresentedOpen, usePresentedHost, loadChangesSummary, loadChangesDiff, reloadPresentedHost, openChanged, t, }: ReviewTabProps): ReactNode;
+//# sourceMappingURL=ReviewTab.d.ts.map

package/lib/types/client/changes-diff.d.ts

@@ -0,0 +1,22 @@
+/** Cache of the file comparisons the Host serves for listed changed files, read once per comparison and again after a failure. */
+import type { SessionId } from '@qilin-agent/session/types';
+import { type ChangesDiff } from '../changes.ts';
+import { HostReadStore } from './host-read-store.ts';
+/**
+ * A comparison, `'missing'` once the Host no longer serves it, `'error'` for
+ * a failed read a later request retries, or `'loading'` while the request runs.
+ */
+export type ChangesDiffState = ChangesDiff | 'missing' | 'error' | 'loading';
+/** One browser plugin's comparison reads; a failed read is the one state a later request replaces. */
+export declare class ChangesDiffStore extends HostReadStore<ChangesDiffState> {
+    constructor();
+    /**
+     * Read one comparison; a cached comparison or a missing one is kept, a failed one is read again.
+     * @param sessionId - viewed Session.
+     * @param seq - the announcing event's sequence.
+     * @param index - the file's index in the summary.
+     * @returns after the state is published.
+     */
+    load(sessionId: SessionId, seq: number, index: number): Promise<void>;
+}
+//# sourceMappingURL=changes-diff.d.ts.map

package/lib/types/client/changes-summary.d.ts

@@ -0,0 +1,18 @@
+/** Fetch-once cache of the change summaries the Host serves for announced `workspace/changes` events. */
+import type { SessionId } from '@qilin-agent/session/types';
+import { type ChangesSummary } from '../changes.ts';
+import { HostReadStore } from './host-read-store.ts';
+/** A summary, `'missing'` once the Host no longer serves it, or `'loading'` while the request runs. */
+export type ChangesSummaryState = ChangesSummary | 'missing' | 'loading';
+/** One browser plugin's summary reads; a summary or a missing answer is kept until the connection is replaced. */
+export declare class ChangesSummaryStore extends HostReadStore<ChangesSummaryState> {
+    constructor();
+    /**
+     * Read one summary once; a later read of the same coordinates returns the cached state.
+     * @param sessionId - viewed Session.
+     * @param seq - the announcing event's sequence.
+     * @returns after the state is published.
+     */
+    load(sessionId: SessionId, seq: number): Promise<void>;
+}
+//# sourceMappingURL=changes-summary.d.ts.map