@parallelworks/ui 0.21.2 → 0.23.0

package/dist/ai/components/usePasteCards.js

@@ -0,0 +1,129 @@
+import { countLines, normalizeNewlines, utf8Bytes } from "../core/pastes.js";
+import { useCallback, useEffect, useRef, useState } from "react";
+//#region src/ai/components/usePasteCards.ts
+function appendText(box, text) {
+	return box.trim() ? `${box}\n\n${text}` : text;
+}
+/** Keeps the composer's cards in step with the model, so text or card shows how each paste is sent. */
+function usePasteCards(pastes, input, setInput) {
+	const [cards, setCards] = useState([]);
+	const inBox = useRef([]);
+	const saved = useRef(/* @__PURE__ */ new Map());
+	const uploading = useRef(/* @__PURE__ */ new Set());
+	const seq = useRef(0);
+	const latest = useRef({
+		cards,
+		input,
+		pastes,
+		setInput
+	});
+	latest.current = {
+		cards,
+		input,
+		pastes,
+		setInput
+	};
+	const addCard = useCallback((text) => {
+		const target = latest.current.pastes;
+		if (!target) return;
+		seq.current += 1;
+		const card = {
+			key: `paste-${seq.current}`,
+			text,
+			lines: countLines(text),
+			bytes: utf8Bytes(text)
+		};
+		const known = saved.current.get(text);
+		if (known) {
+			setCards((current) => [...current, {
+				...card,
+				paste: known
+			}]);
+			return;
+		}
+		setCards((current) => [...current, card]);
+		uploading.current.add(card.key);
+		const settle = (result) => {
+			const waiting = uploading.current.delete(card.key);
+			if ("unsupported" in result) {
+				setCards((current) => current.filter((c) => c.key !== card.key));
+				if (waiting) latest.current.setInput(appendText(latest.current.input, text));
+				return;
+			}
+			if ("paste" in result) saved.current.set(text, result.paste);
+			setCards((current) => current.map((c) => {
+				if (c.key !== card.key) return c;
+				return "error" in result ? {
+					...c,
+					error: result.error
+				} : {
+					...c,
+					paste: result.paste
+				};
+			}));
+		};
+		target.upload(text).then(settle, (err) => settle({ error: err instanceof Error ? err.message : String(err) }));
+	}, []);
+	/** Reports whether the paste became a card, so the caller stops the browser pasting it too. */
+	const handleTextPaste = (raw) => {
+		if (!pastes || !raw) return false;
+		const text = normalizeNewlines(raw);
+		const bytes = utf8Bytes(text);
+		if (pastes.inlineMaxBytes === void 0 || bytes <= pastes.inlineMaxBytes && utf8Bytes(input) + bytes <= 1048576) {
+			if (bytes >= 1e3) inBox.current.push(text);
+			return false;
+		}
+		addCard(text);
+		return true;
+	};
+	const inlineMax = pastes?.inlineMaxBytes;
+	useEffect(() => {
+		if (inlineMax === void 0) return;
+		const { cards: current, input: box, setInput: set } = latest.current;
+		const boxed = inBox.current.filter((text) => box.includes(text));
+		const outgrown = boxed.filter((text) => utf8Bytes(text) > inlineMax);
+		let boxBytes = utf8Bytes(box) - outgrown.reduce((sum, text) => sum + utf8Bytes(text), 0);
+		for (const text of boxed.toReversed()) {
+			if (boxBytes <= 1048576) break;
+			if (!outgrown.includes(text)) {
+				outgrown.push(text);
+				boxBytes -= utf8Bytes(text);
+			}
+		}
+		const fitting = current.filter((c) => {
+			if (c.bytes > inlineMax || boxBytes + c.bytes > 1048576) return false;
+			boxBytes += c.bytes;
+			return true;
+		});
+		if (fitting.length === 0 && outgrown.length === 0) return;
+		let next = box;
+		for (const text of outgrown) next = next.replace(text, () => "");
+		for (const card of fitting) {
+			next = appendText(next, card.text);
+			uploading.current.delete(card.key);
+		}
+		inBox.current = [...inBox.current.filter((text) => !outgrown.includes(text)), ...fitting.map((c) => c.text)];
+		setCards((cs) => cs.filter((c) => !fitting.some((f) => f.key === c.key)));
+		set(next);
+		for (const text of outgrown) addCard(text);
+	}, [inlineMax, addCard]);
+	return {
+		cards,
+		handleTextPaste,
+		removeCard: useCallback((key) => {
+			uploading.current.delete(key);
+			setCards((current) => current.filter((c) => c.key !== key));
+		}, []),
+		takeCards: useCallback(() => {
+			const sent = latest.current.cards.flatMap((c) => c.paste ? [c.paste] : []);
+			setCards([]);
+			uploading.current.clear();
+			inBox.current = [];
+			saved.current.clear();
+			return sent;
+		}, []),
+		blocking: cards.some((c) => !c.paste)
+	};
+}
+//#endregion
+export { usePasteCards };

package/dist/ai/core/ChatProvider.d.ts

@@ -1,6 +1,6 @@
 import { type ReactNode } from 'react';
 import type { ChatAdapter } from '../adapter/types.js';
-import type { AttachmentMeta, ChatModel, ChatNavigation, ChatNotify, ChatUser, Conversation, ConversationSummary, ChatMessage as Message, MessagePart, ProviderInfo, UnreachableSession } from '../types.js';
+import type { AttachmentMeta, ChatModel, ChatNavigation, ChatNotify, ChatUser, Conversation, ConversationSummary, ChatMessage as Message, MessagePart, ProviderInfo, ProviderIssue, UnreachableSession } from '../types.js';
 import { type ChatUIConfig } from './config.js';
 interface ChatContextValue {
     adapter: ChatAdapter;
@@ -13,6 +13,7 @@ interface ChatContextValue {
     providers: ProviderInfo[];
     models: ChatModel[];
     unreachableSessions: UnreachableSession[];
+    providerIssues: ProviderIssue[];
     selectedProvider: string | null;
     isSelectedModelAvailable: boolean;
     selectedAllocation: string | null;

package/dist/ai/core/ChatProvider.js

@@ -1,6 +1,7 @@
 import { applyPartDelta, finalizeParts } from "./parts.js";
 import { chatReducer, initialState } from "./chatReducer.js";
 import { ChatConfigProvider, resolveChatConfig } from "./config.js";
+import { providerIssueFor } from "./providerIssues.js";
 import { useSSEStream } from "./useSSEStream.js";
 import { createContext, useCallback, useContext, useEffect, useMemo, useReducer, useRef } from "react";
 import { jsx } from "react/jsx-runtime";
@@ -195,17 +196,19 @@ function ChatProvider({ adapter, currentUser, navigation, notify, activeConversa
 			isLoadingModels: true
 		});
 		try {
-			const { models, unreachableSessions } = await adapter.models.list();
+			const { models, unreachableSessions, providerIssues } = await adapter.models.list();
 			dispatch({
 				type: "SET_MODELS",
 				models,
-				unreachableSessions
+				unreachableSessions,
+				providerIssues
 			});
 			hasLoadedModelsRef.current = true;
 			const current = selectedProviderRef.current;
 			const stored = readStoredModel();
 			const offers = (id) => !!id && models.some((m) => m.id === id);
-			const resolved = offers(current) ? current : offers(stored) ? stored : models[0]?.id ?? null;
+			const firstUsable = models.find((model) => !providerIssueFor(providerIssues, model)) ?? models[0];
+			const resolved = offers(current) ? current : offers(stored) ? stored : firstUsable?.id ?? null;
 			if (resolved !== current) dispatch({
 				type: "SET_SELECTED_PROVIDER",
 				providerId: resolved
@@ -750,6 +753,7 @@ function ChatProvider({ adapter, currentUser, navigation, notify, activeConversa
 		providers: state.providers,
 		models: state.models,
 		unreachableSessions: state.unreachableSessions,
+		providerIssues: state.providerIssues,
 		selectedProvider: state.selectedProvider,
 		isSelectedModelAvailable,
 		selectedAllocation: state.selectedAllocation,

package/dist/ai/core/chatReducer.d.ts

@@ -1,11 +1,12 @@
 import type { PartDelta } from '../adapter/types.js';
-import type { ChatMessage, ChatModel, Conversation, ConversationSummary, MessagePart, ProviderInfo, UnreachableSession } from '../types.js';
+import type { ChatMessage, ChatModel, Conversation, ConversationSummary, MessagePart, ProviderInfo, ProviderIssue, UnreachableSession } from '../types.js';
 export interface ChatState {
     conversations: ConversationSummary[];
     currentConversation: Conversation | null;
     providers: ProviderInfo[];
     models: ChatModel[];
     unreachableSessions: UnreachableSession[];
+    providerIssues: ProviderIssue[];
     selectedProvider: string | null;
     selectedAllocation: string | null;
     isLoading: boolean;
@@ -35,6 +36,7 @@ export type ChatAction = {
     type: 'SET_MODELS';
     models: ChatModel[];
     unreachableSessions?: UnreachableSession[];
+    providerIssues?: ProviderIssue[];
 } | {
     type: 'SET_SELECTED_PROVIDER';
     providerId: string | null;

package/dist/ai/core/chatReducer.js

@@ -6,6 +6,7 @@ var initialState = {
 	providers: [],
 	models: [],
 	unreachableSessions: [],
+	providerIssues: [],
 	selectedProvider: null,
 	selectedAllocation: null,
 	isLoading: false,
@@ -80,6 +81,7 @@ function chatReducer(state, action) {
 			...state,
 			models: action.models,
 			unreachableSessions: action.unreachableSessions || [],
+			providerIssues: action.providerIssues || [],
 			hasLoadedModels: true,
 			modelsError: null
 		};

package/dist/ai/core/pastes.d.ts

@@ -0,0 +1,14 @@
+import type { MessagePaste } from '../types.js';
+/** Pastes this small never turn into a card, whatever the model. */
+export declare const PASTE_CARD_MIN_BYTES = 1000;
+/** The most text sent inline, for one paste and for a whole message. */
+export declare const PASTE_INLINE_CAP: number;
+export declare function utf8Bytes(text: string): number;
+/** Terminals and some browsers put CR line endings on the clipboard. */
+export declare function normalizeNewlines(text: string): string;
+/** Counts lines as a paste's label shows them: a final newline starts none. */
+export declare function countLines(text: string): number;
+/** The inline limit for a context window, for a host that has not reported its own. */
+export declare function pasteInlineMaxBytes(contextWindow: number | undefined): number;
+/** Splits a message into its text and the pastes its placeholders stand for. */
+export declare function splitPastes(content: string, pastes: MessagePaste[]): (string | MessagePaste)[];

package/dist/ai/core/pastes.js

@@ -0,0 +1,43 @@
+//#region src/ai/core/pastes.ts
+/** Pastes this small never turn into a card, whatever the model. */
+var PASTE_CARD_MIN_BYTES = 1e3;
+/** The most text sent inline, for one paste and for a whole message. */
+var PASTE_INLINE_CAP = 1 << 20;
+var DEFAULT_CONTEXT_WINDOW = 128e3;
+var encoder = new TextEncoder();
+function utf8Bytes(text) {
+	return encoder.encode(text).length;
+}
+/** Terminals and some browsers put CR line endings on the clipboard. */
+function normalizeNewlines(text) {
+	return text.replace(/\r\n?/g, "\n");
+}
+/** Counts lines as a paste's label shows them: a final newline starts none. */
+function countLines(text) {
+	return (text.endsWith("\n") ? text.slice(0, -1) : text).split("\n").length;
+}
+/** The inline limit for a context window, for a host that has not reported its own. */
+function pasteInlineMaxBytes(contextWindow) {
+	return Math.min(Math.floor((contextWindow || DEFAULT_CONTEXT_WINDOW) * 4 / 10), PASTE_INLINE_CAP);
+}
+function escapeRegExp(text) {
+	return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/** Splits a message into its text and the pastes its placeholders stand for. */
+function splitPastes(content, pastes) {
+	const byPlaceholder = new Map(pastes.map((p) => [p.placeholder, p]));
+	if (byPlaceholder.size === 0) return [content];
+	const pattern = new RegExp([...byPlaceholder.keys()].map(escapeRegExp).join("|"), "g");
+	const out = [];
+	let last = 0;
+	for (const match of content.matchAll(pattern)) {
+		if (match.index > last) out.push(content.slice(last, match.index));
+		const paste = byPlaceholder.get(match[0]);
+		if (paste) out.push(paste);
+		last = match.index + match[0].length;
+	}
+	if (last < content.length) out.push(content.slice(last));
+	return out;
+}
+//#endregion
+export { PASTE_CARD_MIN_BYTES, PASTE_INLINE_CAP, countLines, normalizeNewlines, pasteInlineMaxBytes, splitPastes, utf8Bytes };

package/dist/ai/core/providerIssues.d.ts

@@ -0,0 +1,2 @@
+import type { ChatModel, ProviderIssue } from '../types.js';
+export declare function providerIssueFor(issues: ProviderIssue[], model: Pick<ChatModel, 'provider_name' | 'provider_owner'> | undefined): ProviderIssue | undefined;

package/dist/ai/core/providerIssues.js

@@ -0,0 +1,7 @@
+//#region src/ai/core/providerIssues.ts
+function providerIssueFor(issues, model) {
+	if (!model?.provider_name) return;
+	return issues.find((issue) => issue.provider_name === model.provider_name && (issue.provider_owner ?? "") === (model.provider_owner ?? ""));
+}
+//#endregion
+export { providerIssueFor };

package/dist/ai/index.d.ts

@@ -20,8 +20,10 @@ export { ComposerContext, ComposerControls, ComposerSettings, ConnectToolsLink,
 export { default as ComposerFrame } from './components/ComposerFrame.js';
 export { default as DragOverlay } from './components/DragOverlay.js';
 export { default as ModelSelector, getProviderKeyFromModelId, } from './components/ModelSelector.js';
+export { default as ProviderIssueBanner } from './components/ProviderIssueBanner.js';
 export { default as ShareDialog, ShareButton, } from './components/ShareDialog.js';
 export { type SlashCommandOption, type SlashMenuConfig, slashMatches, } from './components/SlashMenu.js';
+export type { ComposerPastes, PasteUploadResult, } from './components/usePasteCards.js';
 export { ChatProvider, type ChatProviderProps, useChat, } from './core/ChatProvider.js';
 export { type ChatAction, type ChatState, chatReducer, initialState, } from './core/chatReducer.js';
 export type { PartRendererProps } from './core/config.js';
@@ -30,6 +32,8 @@ export { FOCUS_SIDEBAR_SEARCH_EVENT } from './core/events.js';
 export { getGreeting } from './core/greeting.js';
 export { KeyboardShortcutsProvider } from './core/KeyboardShortcutsProvider.js';
 export { applyPartDelta, finalizeParts } from './core/parts.js';
+export { pasteInlineMaxBytes } from './core/pastes.js';
+export { providerIssueFor } from './core/providerIssues.js';
 export { default as useDragDrop } from './core/useDragDrop.js';
 export { useKeyboardShortcuts } from './core/useKeyboardShortcuts.js';
 export { type ChatStrings, defaultChatStrings } from './strings.js';

package/dist/ai/index.js

@@ -10,6 +10,7 @@ import { applyPartDelta, finalizeParts } from "./core/parts.js";
 import { chatReducer, initialState } from "./core/chatReducer.js";
 import { defaultChatStrings } from "./strings.js";
 import { resolveChatConfig, useChatConfig } from "./core/config.js";
+import { providerIssueFor } from "./core/providerIssues.js";
 import { ChatProvider, useChat } from "./core/ChatProvider.js";
 import Dropdown from "./ui/Dropdown.js";
 import { formatFileSize, isMac, isOrgModel } from "./utils.js";
@@ -26,8 +27,10 @@ import { getGreeting } from "./core/greeting.js";
 import useDragDrop from "./core/useDragDrop.js";
 import { ComposerContext, ComposerControls, ComposerSettings, ConnectToolsLink } from "./components/ComposerChrome.js";
 import DragOverlay from "./components/DragOverlay.js";
+import { pasteInlineMaxBytes } from "./core/pastes.js";
 import { slashMatches } from "./components/SlashMenu.js";
 import ChatInput from "./components/ChatInput.js";
+import ProviderIssueBanner from "./components/ProviderIssueBanner.js";
 import ChatEmptyState from "./components/ChatEmptyState.js";
 import { FOCUS_SIDEBAR_SEARCH_EVENT } from "./core/events.js";
 import { useKeyboardShortcuts } from "./core/useKeyboardShortcuts.js";
@@ -41,4 +44,4 @@ import ChatMessageList from "./components/ChatMessageList.js";
 import ChatThread from "./components/ChatThread.js";
 import ComposerFrame from "./components/ComposerFrame.js";
 import { NoticeBar, NoticeCard } from "./ui/Notice.js";
-export { AGENT_COLOR_NAMES, ActivityLine, AgentMessageParts, AllocationSelector, ApprovalBlock, AttachmentManager, AttachmentUpload, BlockedGroupBanner, BranchNavigator, ChatAdapterError, ChatEmptyState, ChatInput, ChatLayout, ChatMessageList, ChatMessage_default as ChatMessageView, ChatProvider, ChatSidebar, ChatThread, ComposerContext, ComposerControls, ComposerFrame, ComposerSettings, ConnectToolsLink, DEFAULT_PERMISSION_MODE, DragOverlay, Dropdown, FOCUS_SIDEBAR_SEARCH_EVENT, INTERRUPTED_NOTICE, KeyboardShortcutsProvider, MAX_EDIT_DIFF_LINES, MAX_WRITE_DIFF_LINES, ModelSelector, NAMED_PERMISSION_MODES, NoticeBar, NoticeCard, PermissionPicker, RenameDialog, ShareButton, ShareDialog, SidebarGroupHeading, SidebarPanel, SidebarRailItem, SidebarRow, SidebarToggle, agentColorHex, agentTypeLabel, applyPartDelta, askQuestionFromArgs, bashExitCode, chatReducer, clampPermissionMode, classifyPseudoUserMessage, clip, compactCount, computeEditDiff, computeWriteRows, defaultChatStrings, durationToAbsHumanDuration, editSummary, finalizeParts, firstNonEmptyLine, formatElapsed, formatFileSize, fullToolArgs, getGreeting, getProviderKeyFromModelId, hiddenTranscriptTool, initialState, interruptionNotice, isEditDiffTool, isGroupableTool, isMac, isNamedPermissionMode, isOrgModel, languageForPath, lineDelta, parseEditArgs, parseSubagentNotice, permissionModesUpTo, planFromArgs, plural, resolveChatConfig, resultFailed, rollupSentence, sanitizeLabel, sanitizePanelText, slashMatches, subagentDeliveryLine, summarizeToolArgs, taskCallFromArgs, thinkingHeading, tokenizeDiffLines, toolHeaderFor, toolSummary, useChat, useChatConfig, useDragDrop, useKeyboardShortcuts, useRowDialogs, wordEmphasisRanges };
+export { AGENT_COLOR_NAMES, ActivityLine, AgentMessageParts, AllocationSelector, ApprovalBlock, AttachmentManager, AttachmentUpload, BlockedGroupBanner, BranchNavigator, ChatAdapterError, ChatEmptyState, ChatInput, ChatLayout, ChatMessageList, ChatMessage_default as ChatMessageView, ChatProvider, ChatSidebar, ChatThread, ComposerContext, ComposerControls, ComposerFrame, ComposerSettings, ConnectToolsLink, DEFAULT_PERMISSION_MODE, DragOverlay, Dropdown, FOCUS_SIDEBAR_SEARCH_EVENT, INTERRUPTED_NOTICE, KeyboardShortcutsProvider, MAX_EDIT_DIFF_LINES, MAX_WRITE_DIFF_LINES, ModelSelector, NAMED_PERMISSION_MODES, NoticeBar, NoticeCard, PermissionPicker, ProviderIssueBanner, RenameDialog, ShareButton, ShareDialog, SidebarGroupHeading, SidebarPanel, SidebarRailItem, SidebarRow, SidebarToggle, agentColorHex, agentTypeLabel, applyPartDelta, askQuestionFromArgs, bashExitCode, chatReducer, clampPermissionMode, classifyPseudoUserMessage, clip, compactCount, computeEditDiff, computeWriteRows, defaultChatStrings, durationToAbsHumanDuration, editSummary, finalizeParts, firstNonEmptyLine, formatElapsed, formatFileSize, fullToolArgs, getGreeting, getProviderKeyFromModelId, hiddenTranscriptTool, initialState, interruptionNotice, isEditDiffTool, isGroupableTool, isMac, isNamedPermissionMode, isOrgModel, languageForPath, lineDelta, parseEditArgs, parseSubagentNotice, pasteInlineMaxBytes, permissionModesUpTo, planFromArgs, plural, providerIssueFor, resolveChatConfig, resultFailed, rollupSentence, sanitizeLabel, sanitizePanelText, slashMatches, subagentDeliveryLine, summarizeToolArgs, taskCallFromArgs, thinkingHeading, tokenizeDiffLines, toolHeaderFor, toolSummary, useChat, useChatConfig, useDragDrop, useKeyboardShortcuts, useRowDialogs, wordEmphasisRanges };

package/dist/ai/strings.d.ts

@@ -25,6 +25,14 @@ export interface ChatStrings {
         title: string;
         message: string;
     };
+    providerIssue: {
+        keyRejected: string;
+        unreachable: string;
+        keyRejectedHint: string;
+        unreachableHint: string;
+        bannerKeyRejected: (provider: string) => string;
+        bannerUnreachable: (provider: string) => string;
+    };
     queue: {
         remove: string;
     };
@@ -51,6 +59,12 @@ export interface ChatStrings {
         sendMessage: string;
         filesAttached: (count: number) => string;
     };
+    paste: {
+        title: string;
+        lines: (count: number) => string;
+        saving: string;
+        remove: string;
+    };
     thinking: {
         label: string;
         ellipsis: string;

package/dist/ai/strings.js

@@ -33,6 +33,14 @@ var defaultChatStrings = {
 		message: "It has reached its allocation limit. Messages to this provider are paused until your administrator increases the allocation."
 	},
 	queue: { remove: "Remove queued message" },
+	providerIssue: {
+		keyRejected: "API key rejected",
+		unreachable: "Endpoint unreachable",
+		keyRejectedHint: "The provider rejected this connection’s API key. Update the key in the provider settings to resume.",
+		unreachableHint: "The provider’s endpoint did not respond. Check the endpoint URL and network access.",
+		bannerKeyRejected: (provider) => `API key rejected for \u201c${provider}\u201d`,
+		bannerUnreachable: (provider) => `\u201c${provider}\u201d is unreachable`
+	},
 	activity: {
 		tokens: (input, output) => `↑${input} ↓${output} tokens`,
 		stop: "Stop"
@@ -60,6 +68,12 @@ var defaultChatStrings = {
 		sendMessage: "Send message (Enter)",
 		filesAttached: (count) => `${count} file${count > 1 ? "s" : ""} attached`
 	},
+	paste: {
+		title: "Pasted text",
+		lines: (count) => `${count.toLocaleString()} line${count === 1 ? "" : "s"}`,
+		saving: "Saving…",
+		remove: "Remove paste"
+	},
 	thinking: {
 		label: "Thinking",
 		ellipsis: "Thinking...",

package/dist/ai/types.d.ts

@@ -120,6 +120,16 @@ export interface TodoSnapshotPart {
 export type MessagePart = TextPart | ReasoningPart | ToolCallPart | SubagentPart | ApprovalPart | NoticePart | TodoSnapshotPart;
 export type MessagePartKind = MessagePart['kind'];
 export type PseudoUserKind = 'command-input' | 'shell-input' | 'compaction';
+/** A saved paste a user message names by its placeholder. The model got an
+ *  inline paste as text; a larger one as its saved file. */
+export interface MessagePaste {
+    placeholder: string;
+    id: number;
+    lines: number;
+    bytes: number;
+    inline?: boolean | undefined;
+    text?: string | undefined;
+}
 export interface ChatMessage {
     id: string;
     role: string;
@@ -141,6 +151,7 @@ export interface ChatMessage {
     error?: string | null | undefined;
     parts?: MessagePart[] | null | undefined;
     pseudo?: PseudoUserKind | null | undefined;
+    pastes?: MessagePaste[] | null | undefined;
 }
 export interface Conversation {
     id: string;
@@ -187,6 +198,13 @@ export interface UnreachableSession {
     name: string;
     owner: string;
 }
+export interface ProviderIssue {
+    provider: string;
+    provider_name: string;
+    provider_owner?: string;
+    status: 'unauthorized' | 'unreachable';
+    message?: string;
+}
 export type CspKind = 'openai' | 'anthropic' | 'google' | 'azure' | 'aws' | 'other';
 export interface ProviderInfo {
     id: string;

package/dist/components/Provider.d.ts

@@ -133,6 +133,7 @@ export interface UIStrings {
             errorTitle: string;
             previewError: string;
             tooLarge: string;
+            tooLargeSize: (size: string) => string;
             downloadInstead: string;
             archiveTitle: string;
             archiveMessage: string;

package/dist/components/Provider.js

@@ -137,6 +137,7 @@ var DEFAULTS = {
 				errorTitle: "Couldn't load preview",
 				previewError: "This file couldn't be previewed in your browser.",
 				tooLarge: "This file is too large to preview in the browser.",
+				tooLargeSize: (size) => `This file is ${size}, too large to preview in the browser.`,
 				downloadInstead: "Download instead",
 				archiveTitle: "Can't preview archives",
 				archiveMessage: "Archive files can't be previewed in the browser. Download the file to view its contents.",

package/dist/file-explorer/FileExplorer.d.ts

@@ -1,3 +1,5 @@
+import { type ReactNode } from 'react';
+import { type RowAction } from '../list/index.js';
 import type { IFileExplorerClient, IFileExplorerProvider } from './lib/fileExplorer.js';
 import type { ExplorerObject, TreeNode, TStorage } from './lib/types.js';
 interface IFileExplorerProps {
@@ -42,6 +44,10 @@ interface IFileExplorerProps {
         label: string;
         build: (objects: ExplorerObject[]) => string;
     } | undefined;
+    /** Host actions for a row's menu, placed after the built-in ones and before Copy. */
+    extraRowActions?: ((node: TreeNode, storage: TStorage | undefined) => RowAction[]) | undefined;
+    /** Host content for the selected folder's header, before its badges. */
+    headerAccessory?: ((node: TreeNode, storage: TStorage | undefined) => ReactNode) | undefined;
 }
-export default function FileExplorer({ storages, onRefresh, refreshKey, onOpenFile, showUserHierarchy, groups, groupsLoading, selectedPath, onPathChange, getProviderAndClient, treeOnly, initialExpandedPaths, onExpandedPathsChange, objectUris, downloadCommand, }: IFileExplorerProps): import("react").JSX.Element;
+export default function FileExplorer({ storages, onRefresh, refreshKey, onOpenFile, showUserHierarchy, groups, groupsLoading, selectedPath, onPathChange, getProviderAndClient, treeOnly, initialExpandedPaths, onExpandedPathsChange, objectUris, downloadCommand, extraRowActions, headerAccessory, }: IFileExplorerProps): import("react").JSX.Element;
 export {};

package/dist/file-explorer/FileExplorer.js

@@ -120,7 +120,7 @@ function TreeFrame({ treeOnly, sidebarWidth, onWidthChange, children }) {
 		children
 	});
 }
-function FileExplorer({ storages, onRefresh, refreshKey, onOpenFile, showUserHierarchy = false, groups = [], groupsLoading = false, selectedPath, onPathChange, getProviderAndClient, treeOnly = false, initialExpandedPaths, onExpandedPathsChange, objectUris, downloadCommand }) {
+function FileExplorer({ storages, onRefresh, refreshKey, onOpenFile, showUserHierarchy = false, groups = [], groupsLoading = false, selectedPath, onPathChange, getProviderAndClient, treeOnly = false, initialExpandedPaths, onExpandedPathsChange, objectUris, downloadCommand, extraRowActions, headerAccessory }) {
 	const copySubmenu = useCopySubmenu();
 	const t = useStrings().fileExplorer;
 	const notify = useNotify();
@@ -636,6 +636,7 @@ function FileExplorer({ storages, onRefresh, refreshKey, onOpenFile, showUserHie
 			});
 		}
 		actions.push(...getCreateFolderActions(node, storage));
+		actions.push(...extraRowActions?.(node, storage) ?? []);
 		if (nodeCanWrite && !node.root) actions.push({
 			key: "delete",
 			label: t.preview.delete,
@@ -1021,6 +1022,7 @@ function FileExplorer({ storages, onRefresh, refreshKey, onOpenFile, showUserHie
 							children: [renderBreadcrumb(), /* @__PURE__ */ jsxs("div", {
 								className: "flex shrink-0 items-center gap-2",
 								children: [
+									headerAccessory?.(selectedNode, findStorage(selectedNode.storageId)),
 									folderHasMore && /* @__PURE__ */ jsx(StatusBadge, {
 										variant: "muted",
 										className: "whitespace-nowrap tabular-nums",