quassel 0.2.2 → 0.4.0

package/ChatActionDock.d.ts

@@ -0,0 +1,2 @@
+/** Target of open actions: undefined = in the transcript, null = the dock above the input is not mounted yet. */
+export declare const ChatActionDock: import("react").Context<HTMLElement | null | undefined>;

package/ChatInputToolbar.d.ts

@@ -2,7 +2,7 @@ import { ReactNode, Ref } from "react";
 import { ChatTexts } from "./texts";
 import type { ChatAttachmentInput } from "./events";
 import type { SendShortcut } from "./options";
-/** Ein Toolbar-Knopf, deklarativ: Symbol, Text oder beides - plus Klick-Handler. */
+/** A toolbar button, declarative: icon, text or both - plus click handler. */
 export interface ToolbarAction {
     icon?: ReactNode;
     label?: string;
@@ -11,9 +11,9 @@ export interface ToolbarAction {
     active?: boolean;
     onClick: () => void;
 }
-/** Hosts steuern den Entwurf von aussen, z.B. um eine Vorlage zum Bearbeiten einzusetzen. */
+/** Hosts control the draft from outside, e.g. to insert a template for editing. */
 export interface ChatInputHandle {
-    /** Ersetzt den Entwurf, fokussiert die Eingabe und stellt die Schreibmarke ans Ende. */
+    /** Replaces the draft, focuses the input and puts the caret at the end. */
     insert: (text: string) => void;
     focus: () => void;
     reset: () => void;
@@ -22,11 +22,11 @@ export interface ChatInputHandle {
     }) => Promise<void>;
 }
 /**
- * Die Eingabe-Karte: rahmenlose Textarea oben, Toolbar unter einer Haarlinie. Eigene
- * Knöpfe kommen deklarativ über `actions` oder frei über die Slots links/rechts; bei
- * laufender Arbeit bleibt der Stop-Knopf sichtbar, und Tippen zeigt daneben den Senden-Knopf,
- * der zum Dazwischenfunken wird. `rows` bestimmt die Starthöhe; mit `maxRows` wächst die Textarea
- * mit dem Inhalt bis zu dieser Zeilenzahl und scrollt danach.
+ * The input card: borderless textarea on top, toolbar below a hairline. Custom buttons come
+ * declaratively through `actions` or freely through the left/right slots; while work is running
+ * the stop button stays visible, and typing shows the send button next to it, which then
+ * interjects. `rows` sets the initial height; with `maxRows` the textarea grows with its content
+ * up to that number of rows and scrolls after that.
  */
 export declare function ChatInputToolbar({ onSend, onStop, running, disabled, sendDisabled, layout, detailsContainer, onErrorChange, inputAriaControls, rows, maxRows, actions, toolbarLeft, toolbarRight, texts, handleRef, attachments: attachmentsEnabled, attachmentCapabilities, attachmentCapabilitiesError, onAttachmentsChange, initialValue, onDraftChange, sendShortcut, autoFocus, onAutoFocusSettled, }: {
     onSend: (text: string, attachments?: ChatAttachmentInput[]) => void | Promise<void>;
@@ -45,7 +45,7 @@ export declare function ChatInputToolbar({ onSend, onStop, running, disabled, se
     toolbarRight?: ReactNode;
     texts?: Partial<ChatTexts>;
     handleRef?: Ref<ChatInputHandle>;
-    /** false = kein Anhängen: weder Knopf noch Ablegen oder Einfügen von Dateien. */
+    /** false = no attaching: neither button nor dropping or pasting files. */
     attachments?: boolean;
     attachmentCapabilities?: {
         input: readonly string[];

package/ChatMessages.d.ts

@@ -4,34 +4,34 @@ import { ChatTexts } from "./texts";
 import { type LinkClickHandler } from "./Markdown";
 import { type ChatAppearance, type TimestampOptions, type CodeBlockOptions, type BubbleOptions, type MessageActionsOptions } from "./options";
 /**
- * Der Verlauf: eigener Scroll-Container mit Autoscroll, solange man unten ist,
- * und einem Zum-Ende-Knopf, sobald man liest. Ohne Eingabe read-only nutzbar.
+ * The transcript: its own scroll container with autoscroll while you are at the bottom, and a
+ * jump-to-end button as soon as you are reading. Usable read-only without a composer.
  */
-export declare function ChatMessages({ messages, owner, detailMode, running, working, stepsExpandable, texts, toolArgumentsText, renderTool, renderAction, onDismissAction, onLinkClick, emptyState, className, scrollerClassName, showTimestamps, announce, scrollerRef, maxWidth, horizontalPadding, jumpToEndThreshold, appearance, timestampOptions, codeBlockOptions, bubbleOptions, messageActions, }: {
+export declare function ChatMessages({ messages, owner, detailMode, running, working, stepsExpandable, texts, toolArgumentsText, renderTool, renderAction, onDismissAction, onLinkClick, emptyState, className, scrollerClassName, showTimestamps, announce, scrollerRef, maxWidth, horizontalPadding, jumpToEndThreshold, appearance, timestampOptions, codeBlockOptions, bubbleOptions, messageActions, toolElapsedThreshold, }: {
     messages: Message[];
-    /** Beiträge mit diesem Message.sender erscheinen ohne Sprechblase; null behält die Nachrichtenvorgaben. */
+    /** Contributions with this Message.sender appear without a speech bubble; null keeps the message defaults. */
     owner?: string | null;
     detailMode?: DetailMode;
     running?: boolean;
     working?: ReactNode;
-    /** false = Denk- und Werkzeug-Schritte lassen sich nicht aufklappen (kein Popover). */
+    /** false = thinking and tool steps cannot be expanded (no popover). */
     stepsExpandable?: boolean;
     texts?: Partial<ChatTexts>;
     toolArgumentsText?: (tool: ToolInfo) => string;
-    /** Eigene Darstellung fuer einzelne Werkzeuge; undefined = Standarddarstellung. */
+    /** Custom rendering for single tools; undefined = default rendering. */
     renderTool?: (tool: ToolInfo) => ReactNode | undefined;
-    /** Darstellung einer wartenden Aktion durch ihren Eigentümer; undefined = generische Karte. */
+    /** Rendering of a pending action by its owner; undefined = generic card. */
     renderAction?: (action: PendingAction, text: string) => ReactNode | undefined;
     onDismissAction?: (actionId: string) => void;
-    /** Faengt Klicks auf Markdown-Links ab; true = behandelt, der Browser folgt nicht. */
+    /** Intercepts clicks on Markdown links; true = handled, the browser does not follow. */
     onLinkClick?: LinkClickHandler;
     emptyState?: ReactNode;
     className?: string;
-    /** Klassen des Hosts für den Scroll-Container (data-quassel-transcript). */
+    /** Host classes for the scroll container (data-quassel-transcript). */
     scrollerClassName?: string;
-    /** true = dezente HH:MM-Spalte links an jedem Block (Message.at). */
+    /** true = subtle HH:MM column to the left of each block (Message.at). */
     showTimestamps?: boolean;
-    /** Screenreader-Ansage fertiger Antworten und neuer Aktionen; false = der Host sagt selbst an. */
+    /** Screen reader announcement of finished answers and new actions; false = the host announces itself. */
     announce?: false | ((announcement: ChatAnnouncement) => string | undefined);
     /** Exposes the scroll container so hosts can scroll without querying the DOM. */
     scrollerRef?: (element: HTMLDivElement | null) => void;
@@ -43,4 +43,6 @@ export declare function ChatMessages({ messages, owner, detailMode, running, wor
     codeBlockOptions?: CodeBlockOptions;
     bubbleOptions?: BubbleOptions;
     messageActions?: MessageActionsOptions;
+    /** Milliseconds before a running tool call shows its elapsed time (from Message.at) while running; false = never. */
+    toolElapsedThreshold?: number | false;
 }): import("react").JSX.Element;

package/ChatPanel.d.ts

@@ -1,12 +1,12 @@
 import { type CSSProperties, type ReactNode, type Ref } from "react";
 import { type ChatAppearance } from "./options";
 /**
- * Verlauf mit ueberlagerter Eingabe. Der Rahmen misst die Eingabe selbst und
- * gibt dem Verlauf den noetigen Fussraum, damit kein Host Innenmasse setzen muss.
+ * Transcript with an overlaid composer. The frame measures the composer itself and gives the
+ * transcript the footer space it needs, so no host has to set inner dimensions.
  */
 export declare function ChatPanel({ children, composer, className, nodeRef, maxWidth, horizontalPadding, appearance, scrollOnSend, }: {
     children: ReactNode;
-    /** Die Eingabe; sie liegt ueber dem Verlauf, nicht darunter. */
+    /** The composer; it lies over the transcript, not below it. */
     composer?: ReactNode;
     className?: string;
     nodeRef?: Ref<HTMLDivElement>;

package/DetailModeSwitch.d.ts

@@ -3,16 +3,14 @@ import { ChatTexts } from "./texts";
 export declare const DETAIL_MODES: readonly DetailMode[];
 export declare const detailModeLabel: (mode: DetailMode, texts?: Partial<ChatTexts>) => string;
 /**
- * Ein Knopf, der den Detailgrad der Denk- und Werkzeug-Schritte weiterschaltet. Die
- * Reihenfolge kommt aus `modes`, der aktuelle Wert steht als Beschriftung daneben.
+ * An icon button that cycles the detail level of the thinking and tool steps. The order comes
+ * from `modes`, the current value shows in the icon and in the tooltip.
  */
-export declare function DetailModeSwitch({ mode, onChange, modes, collapsible, texts, className, }: {
+export declare function DetailModeSwitch({ mode, onChange, modes, texts, className, }: {
     mode: DetailMode;
     onChange: (mode: DetailMode) => void;
-    /** Auswahl und Reihenfolge des Weiterschaltens; Default sind alle Modi. */
+    /** Selection and order of cycling; the default is all modes. */
     modes?: readonly DetailMode[];
-    /** false = die Beschriftung bleibt auch in einer schmalen Eingabe-Karte stehen. */
-    collapsible?: boolean;
     texts?: Partial<ChatTexts>;
     className?: string;
 }): import("react").JSX.Element;

package/Markdown.d.ts

@@ -15,5 +15,5 @@ export declare function Markdown({ text, streaming }: {
     text: string;
     streaming?: boolean;
 }): import("react").JSX.Element;
-/** Dieselbe Syntax wie der Renderer, als Klartext ohne Markup, etwa für Screenreader-Ansagen. */
+/** The same syntax as the renderer, as plain text without markup, e.g. for screen reader announcements. */
 export declare function markdownPlainText(text: string): string;

package/PendingActionCard.d.ts

@@ -1,7 +1,7 @@
 import type { PendingAction } from "./types";
 /**
- * Die Darstellung einer wartenden Aktion ohne Beitrag ihres Eigentümers: Titel, der Hinweis,
- * dass eine Eingabe erwartet wird, und das Verwerfen. Die Form kennt nur das Plugin.
+ * The rendering of a pending action without a contribution from its owner: title, the hint
+ * that input is expected, and dismissing. Only the plugin knows the form.
  */
 export declare function PendingActionCard({ text, action, waitingLabel, dismissLabel, dismissedLabel, onDismiss, }: {
     text: string;

package/README.md

@@ -12,12 +12,15 @@ color, radius, font and font size is a `--qsl-*` variable.
 
 **Agent chats that show their work.** Thinking and tool calls appear as steps. Pick how much
 of them the user sees - only the current step, icons, chips, a collapsible group, single lines
-or everything - and let them switch at runtime.
+or everything - and let them switch at runtime. A tool call that runs longer than a few seconds
+shows how long it has been running, on its row and on the collapsed group header, so a slow step
+does not look like a hung one.
 
 ![The same steps as icons, chips and single lines](https://raw.githubusercontent.com/SchlenkR/quassel/main/docs/images/details.png)
 
 **Pending actions.** The agent waits for input: a generic card with dismiss, or the host's own
-rendering per action owner. Resolved actions stay in the transcript as a record.
+rendering per action owner. Open actions sit right above the input, like a question in a terminal
+agent; resolved actions stay in the transcript as a record.
 
 **Multi-party conversations.** Colored bubbles with labels for agents that talk to each other.
 
@@ -43,7 +46,7 @@ variables too.
 - Timestamps, day separators, message actions, configurable bubbles and appearance.
 - Screen reader friendly: the transcript is not a live region; finished replies and new
   actions are announced once, with the host in control of the wording.
-- All labels are replaceable through `texts` (defaults are German).
+- All labels are replaceable through `texts` (defaults are English).
 
 ## Install
 
@@ -89,12 +92,13 @@ Any backend that emits the `quassel/events` stream works with the same component
 pnpm install
 pnpm dev              # stylesheet in watch mode plus the gallery on http://localhost:3210
 pnpm check            # type check package and gallery
+pnpm test             # package tests (node:test with happy-dom)
 pnpm build            # stylesheet and gallery build
 pnpm release --dry-run
 ```
 
 The full guide - every prop, the event contract, theming, slots, dark mode and publishing -
-is in [docs/guide.md](https://github.com/SchlenkR/quassel/blob/main/docs/guide.md) (German). It is written so that an AI assistant can build
+is in [docs/guide.md](https://github.com/SchlenkR/quassel/blob/main/docs/guide.md). It is written so that an AI assistant can build
 an application with quassel from it.
 
 ## License

package/TimestampSwitch.d.ts

@@ -1,8 +1,7 @@
 import { type ChatTexts } from "./texts";
-export declare function TimestampSwitch({ showTimestamps, onChange, collapsible, texts, className }: {
+export declare function TimestampSwitch({ showTimestamps, onChange, texts, className }: {
     showTimestamps: boolean;
     onChange: (showTimestamps: boolean) => void;
-    collapsible?: boolean;
     texts?: Partial<ChatTexts>;
     className?: string;
 }): import("react").JSX.Element;

package/WorkingScenes.d.ts

@@ -1,12 +1,12 @@
 export interface WorkingScenesProps {
     /** Limits scenes to one or two visible characters for small status fields. */
     compact?: boolean;
-    /** Text fuer Screenreader, Default "Arbeitet ...". */
+    /** Text for screen readers, default "Working ...". */
     label?: string;
 }
 /**
- * Der Default-Working-Indikator: zufaellig rotierende Mini-Szenen. Zufaellige Reihenfolge
- * und Startphase, damit dieselben Szenen nie wie eine Schleife wirken. Ueber die
- * working-Prop von ChatMessages laesst er sich komplett ersetzen.
+ * The default working indicator: randomly rotating mini scenes. Random order and start phase,
+ * so the same scenes never feel like a loop. The working prop of ChatMessages replaces it
+ * completely.
  */
 export declare function WorkingScenes({ label, compact }: WorkingScenesProps): import("react").JSX.Element;

package/announce.d.ts

@@ -1,2 +1,2 @@
-/** Sagt Text über eine gemeinsame, versteckte Live-Region an: gedrosselt, und bei verstecktem Tab angehalten. */
+/** Announces text through a shared, hidden live region: throttled, and paused while the tab is hidden. */
 export declare function announce(text: string): void;

package/chat.css

@@ -87,6 +87,9 @@
   .qsl\:z-\[110\] {
     z-index: 110;
   }
+  .qsl\:-mx-\[16px\] {
+    margin-inline: calc(16px * -1);
+  }
   .qsl\:mx-auto {
     margin-inline: auto;
   }
@@ -200,6 +203,9 @@
   .qsl\:max-h-\[240px\] {
     max-height: 240px;
   }
+  .qsl\:max-h-\[calc\(var\(--qsl-panel-height\,100dvh\)_\/_2\)\] {
+    max-height: calc(var(--qsl-panel-height,100dvh) / 2);
+  }
   .qsl\:max-h-\[min\(70vh\,620px\)\] {
     max-height: min(70vh, 620px);
   }
@@ -377,6 +383,9 @@
   .qsl\:gap-\[5px\] {
     gap: 5px;
   }
+  .qsl\:gap-\[var\(--qsl-chat-dense-message-gap\,8px\)\] {
+    gap: var(--qsl-chat-dense-message-gap,8px);
+  }
   :where(.qsl\:space-y-0 > :not(:last-child)) {
     --tw-space-y-reverse: 0;
     margin-block-start: 0;
@@ -523,6 +532,9 @@
   .qsl\:bg-\[linear-gradient\(to_right\,var\(--qsl-scroll-cover\,var\(--qsl-background\)\)_50\%\,transparent\)_left\/20px_100\%_no-repeat_local\,linear-gradient\(to_left\,var\(--qsl-scroll-cover\,var\(--qsl-background\)\)_50\%\,transparent\)_right\/20px_100\%_no-repeat_local\,linear-gradient\(to_right\,\#00000047\,transparent\)_left\/14px_100\%_no-repeat_scroll\,linear-gradient\(to_left\,\#00000047\,transparent\)_right\/14px_100\%_no-repeat_scroll\] {
     background-image: linear-gradient(to right,var(--qsl-scroll-cover,var(--qsl-background)) 50%,transparent) left/20px 100% no-repeat local,linear-gradient(to left,var(--qsl-scroll-cover,var(--qsl-background)) 50%,transparent) right/20px 100% no-repeat local,linear-gradient(to right,#00000047,transparent) left/14px 100% no-repeat scroll,linear-gradient(to left,#00000047,transparent) right/14px 100% no-repeat scroll;
   }
+  .qsl\:\[mask-image\:linear-gradient\(to_bottom\,\#000_calc\(100\%_-_var\(--qsl-chat-message-gap\,16px\)\)\,transparent\)\] {
+    mask-image: linear-gradient(to bottom,#000 calc(100% - var(--qsl-chat-message-gap,16px)),transparent);
+  }
   .qsl\:\[mask-image\:linear-gradient\(to_bottom\,\#000_calc\(var\(--qsl-fade-edge\)_-_40px\)\,transparent_calc\(var\(--qsl-fade-edge\)_\+_16px\)\)\] {
     mask-image: linear-gradient(to bottom,#000 calc(var(--qsl-fade-edge) - 40px),transparent calc(var(--qsl-fade-edge) + 16px));
   }
@@ -571,6 +583,9 @@
   .qsl\:px-\[7px\] {
     padding-inline: 7px;
   }
+  .qsl\:px-\[16px\] {
+    padding-inline: 16px;
+  }
   .qsl\:px-\[var\(--qsl-chat-horizontal-padding\,24px\)\] {
     padding-inline: var(--qsl-chat-horizontal-padding,24px);
   }
@@ -622,6 +637,9 @@
   .qsl\:pb-\[calc\(var\(--qsl-composer-height\,0px\)_\+_max\(3\.25em\,40px\)\)\] {
     padding-bottom: calc(var(--qsl-composer-height,0px) + max(3.25em, 40px));
   }
+  .qsl\:pb-\[var\(--qsl-chat-message-gap\,16px\)\] {
+    padding-bottom: var(--qsl-chat-message-gap,16px);
+  }
   .qsl\:pl-1 {
     padding-left: var(--qsl-spacing);
   }
@@ -916,6 +934,9 @@
   .qsl\:\[--qsl-scroll-cover\:var\(--qsl-secondary\)\] {
     --qsl-scroll-cover: var(--qsl-secondary);
   }
+  .qsl\:\[-webkit-mask-image\:linear-gradient\(to_bottom\,\#000_calc\(100\%_-_var\(--qsl-chat-message-gap\,16px\)\)\,transparent\)\] {
+    -webkit-mask-image: linear-gradient(to bottom,#000 calc(100% - var(--qsl-chat-message-gap,16px)),transparent);
+  }
   .qsl\:\[-webkit-mask-image\:linear-gradient\(to_bottom\,\#000_calc\(var\(--qsl-fade-edge\)_-_40px\)\,transparent_calc\(var\(--qsl-fade-edge\)_\+_16px\)\)\] {
     -webkit-mask-image: linear-gradient(to bottom,#000 calc(var(--qsl-fade-edge) - 40px),transparent calc(var(--qsl-fade-edge) + 16px));
   }
@@ -951,6 +972,9 @@
   .qsl\:placeholder\:text-muted-foreground::placeholder {
     color: var(--qsl-muted-foreground);
   }
+  .qsl\:empty\:hidden:empty {
+    display: none;
+  }
   .qsl\:focus-within\:pointer-events-auto:focus-within {
     pointer-events: auto;
   }

package/{chunk-IGCFQJZB.js → chunk-3VEL4HEO.js}

@@ -43,29 +43,29 @@ var chatAttachmentMediaType = (name, mediaType) => {
 var parseChatAttachments = (value) => {
   if (value === void 0) return [];
   if (!Array.isArray(value) || value.length > MAX_CHAT_ATTACHMENTS) {
-    throw new Error(`Anh\xE4nge m\xFCssen eine Liste mit h\xF6chstens ${MAX_CHAT_ATTACHMENTS} Dateien sein.`);
+    throw new Error(`Attachments must be a list of at most ${MAX_CHAT_ATTACHMENTS} files.`);
   }
   let total = 0;
   return value.map((entry, index) => {
-    if (!entry || typeof entry !== "object" || Array.isArray(entry)) throw new Error(`Anhang ${index + 1} ist ung\xFCltig.`);
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) throw new Error(`Attachment ${index + 1} is invalid.`);
     const { name, mediaType, data } = entry;
-    if (typeof name !== "string" || !name.trim() || name.length > 255 || /[/\\\u0000-\u001f\u007f]/.test(name) || name === "." || name === "..") throw new Error(`Anhang ${index + 1} ben\xF6tigt einen g\xFCltigen Dateinamen ohne Pfad.`);
+    if (typeof name !== "string" || !name.trim() || name.length > 255 || /[/\\\u0000-\u001f\u007f]/.test(name) || name === "." || name === "..") throw new Error(`Attachment ${index + 1} needs a valid file name without a path.`);
     const normalizedType = typeof mediaType === "string" ? chatAttachmentMediaType(name, mediaType) : "";
     if (!/^[a-z0-9!#$&^_.+-]+\/[a-z0-9!#$&^_.+-]+$/i.test(normalizedType)) {
-      throw new Error(`Anhang ${name} ben\xF6tigt einen g\xFCltigen MIME-Typ.`);
+      throw new Error(`Attachment ${name} needs a valid MIME type.`);
     }
     if (typeof data === "string" && data.length > Math.ceil(MAX_CHAT_ATTACHMENT_BYTES / 3) * 4)
-      throw new Error("Anh\xE4nge d\xFCrfen zusammen h\xF6chstens 20 MiB gro\xDF sein.");
+      throw new Error("Attachments may be at most 20 MiB in total.");
     if (typeof data !== "string" || data.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(data)) {
-      throw new Error(`Anhang ${name} enth\xE4lt ung\xFCltiges Base64.`);
+      throw new Error(`Attachment ${name} contains invalid Base64.`);
     }
     const padding = data.endsWith("==") ? 2 : data.endsWith("=") ? 1 : 0;
     const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
     if (padding && (alphabet.indexOf(data[data.length - padding - 1]) & (padding === 2 ? 15 : 3)) !== 0) {
-      throw new Error(`Anhang ${name} enth\xE4lt nichtkanonisches Base64.`);
+      throw new Error(`Attachment ${name} contains non-canonical Base64.`);
     }
     total += data.length / 4 * 3 - padding;
-    if (total > MAX_CHAT_ATTACHMENT_BYTES) throw new Error("Anh\xE4nge d\xFCrfen zusammen h\xF6chstens 20 MiB gro\xDF sein.");
+    if (total > MAX_CHAT_ATTACHMENT_BYTES) throw new Error("Attachments may be at most 20 MiB in total.");
     return { name, mediaType: normalizedType, data };
   });
 };
@@ -180,4 +180,4 @@ export {
   prettyJson,
   compactToolLine
 };
-//# sourceMappingURL=chunk-IGCFQJZB.js.map
+//# sourceMappingURL=chunk-3VEL4HEO.js.map

package/chunk-3VEL4HEO.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/chat-attachments.ts", "../src/events.ts"],
+  "sourcesContent": ["import type { ChatAttachmentInput } from \"./events\";\n\nexport const MAX_CHAT_ATTACHMENTS = 8;\nexport const MAX_CHAT_ATTACHMENT_BYTES = 20 * 1024 * 1024;\nexport const MAX_CHAT_REQUEST_BYTES = 29 * 1024 * 1024;\n\nexport const chatAttachmentMediaType = (name: string, mediaType: string): string => {\n  const explicit = mediaType.trim().toLowerCase();\n  if (explicit) return explicit === \"video/quicktime\" ? \"video/mov\" : explicit;\n  const types: Record<string, string> = {\n    png: \"image/png\", jpg: \"image/jpeg\", jpeg: \"image/jpeg\", gif: \"image/gif\", webp: \"image/webp\",\n    avif: \"image/avif\", svg: \"image/svg+xml\", pdf: \"application/pdf\",\n    mp4: \"video/mp4\", webm: \"video/webm\", mov: \"video/mov\", mpeg: \"video/mpeg\", mpg: \"video/mpeg\",\n    txt: \"text/plain\", md: \"text/markdown\", csv: \"text/csv\", tsv: \"text/tab-separated-values\",\n    json: \"application/json\", jsonl: \"application/x-ndjson\", xml: \"application/xml\",\n    yaml: \"application/yaml\", yml: \"application/yaml\", ts: \"text/plain\", tsx: \"text/plain\",\n    js: \"application/javascript\", py: \"text/plain\", cs: \"text/plain\", fs: \"text/plain\",\n    html: \"text/html\", css: \"text/css\", log: \"text/plain\",\n  };\n  return types[name.split(\".\").at(-1)?.toLowerCase() ?? \"\"] ?? \"application/octet-stream\";\n};\n\nexport const parseChatAttachments = (value: unknown): ChatAttachmentInput[] => {\n  if (value === undefined) return [];\n  if (!Array.isArray(value) || value.length > MAX_CHAT_ATTACHMENTS) {\n    throw new Error(`Attachments must be a list of at most ${MAX_CHAT_ATTACHMENTS} files.`);\n  }\n  let total = 0;\n  return value.map((entry, index) => {\n    if (!entry || typeof entry !== \"object\" || Array.isArray(entry)) throw new Error(`Attachment ${index + 1} is invalid.`);\n    const { name, mediaType, data } = entry as Record<string, unknown>;\n    if (typeof name !== \"string\" || !name.trim() || name.length > 255 || /[/\\\\\\u0000-\\u001f\\u007f]/.test(name)\n      || name === \".\" || name === \"..\") throw new Error(`Attachment ${index + 1} needs a valid file name without a path.`);\n    const normalizedType = typeof mediaType === \"string\" ? chatAttachmentMediaType(name, mediaType) : \"\";\n    if (!/^[a-z0-9!#$&^_.+-]+\\/[a-z0-9!#$&^_.+-]+$/i.test(normalizedType)) {\n      throw new Error(`Attachment ${name} needs a valid MIME type.`);\n    }\n    if (typeof data === \"string\" && data.length > Math.ceil(MAX_CHAT_ATTACHMENT_BYTES / 3) * 4)\n      throw new Error(\"Attachments may be at most 20 MiB in total.\");\n    if (typeof data !== \"string\" || data.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(data)) {\n      throw new Error(`Attachment ${name} contains invalid Base64.`);\n    }\n    const padding = data.endsWith(\"==\") ? 2 : data.endsWith(\"=\") ? 1 : 0;\n    const alphabet = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/\";\n    if (padding && (alphabet.indexOf(data[data.length - padding - 1]) & (padding === 2 ? 15 : 3)) !== 0) {\n      throw new Error(`Attachment ${name} contains non-canonical Base64.`);\n    }\n    total += data.length / 4 * 3 - padding;\n    if (total > MAX_CHAT_ATTACHMENT_BYTES) throw new Error(\"Attachments may be at most 20 MiB in total.\");\n    return { name, mediaType: normalizedType, data };\n  });\n};\n", "export type Role = \"user\" | \"assistant\" | \"thinking\" | \"tool\" | \"system\" | \"action\";\n\nexport interface ChatAttachmentInput {\n  name: string;\n  mediaType: string;\n  data: string;\n}\n\nexport interface ChatAttachment {\n  name: string;\n  mediaType: string;\n  size: number;\n  url: string;\n}\n\nexport interface ChatAttachmentCapabilities {\n  input: readonly string[];\n  model: string;\n}\n\nexport interface ToolInfo {\n  id: string;\n  name: string;\n  arguments: string;\n  result?: string;\n  isError?: boolean;\n}\n\nexport interface ChatTextCursor {\n  conversationId: string;\n  sequence: number;\n  /** Accumulated non-whitespace UTF-16 units in the turn anchored by sequence. */\n  offset: number;\n}\n\nexport interface ChatJournalCursor {\n  conversationId: string;\n  eventId: string;\n  sequence: number;\n}\n\n/**\n * An action waiting for input from the user. Shape and content of `payload` and `result`\n * belong to the plugin in `owner`; a set `status` means: done, the card is a record.\n */\nexport interface PendingAction {\n  actionId: string;\n  owner: string | null;\n  payload: unknown;\n  status?: \"approved\" | \"dismissed\";\n  result?: unknown;\n}\n\nexport interface Message {\n  key: string;\n  role: Role;\n  /** Sender identifier for display; independent of role and bubble label. */\n  sender?: string;\n  text: string;\n  textCursor?: ChatTextCursor;\n  closed?: boolean;\n  attachments?: ChatAttachment[];\n  tool?: ToolInfo;\n  action?: PendingAction;\n  /** ISO timestamp of the message; display optional (ChatMessages showTimestamps). */\n  at?: string;\n  /** The ActorInput behind an incoming message; the steering mark hangs on it. */\n  inputId?: string;\n  /** The message was fed into an already running turn instead of starting its own. */\n  steered?: boolean;\n  /** Colored speech bubble instead of running text, e.g. for multi-party conversations. */\n  bubble?: { color: string; side: \"start\" | \"end\"; label?: string };\n}\n\nexport interface ChatStartupStatus {\n  status: \"preparing\" | \"failed\";\n  message: string;\n}\n\nexport type ChatEvent =\n  | { kind: \"reset\"; reason?: \"conversation-reset\"; conversationId: string | null }\n  | { kind: \"replay-end\"; conversationId: string | null }\n  | { kind: \"user\"; text: string; inputId?: string; at?: string; attachments?: ChatAttachment[] }\n  | { kind: \"steered\"; inputId: string }\n  | { kind: \"text\"; delta: string; at?: string; cursor: ChatTextCursor }\n  | { kind: \"thinking\"; delta: string; at?: string }\n  | { kind: \"tool\"; id: string; name: string; arguments: string; label?: string; at?: string }\n  | { kind: \"tool-result\"; id: string; result: string; isError?: boolean }\n  | { kind: \"action\"; actionId: string; owner: string | null; text: string; payload: unknown; at?: string }\n  | { kind: \"action-resolved\"; actionId: string; status: \"approved\" | \"dismissed\"; result: unknown }\n  | { kind: \"system\"; text: string; at?: string }\n  | { kind: \"status\"; running: boolean; startup?: ChatStartupStatus }\n  | { kind: \"turn-done\" }\n  | { kind: \"plugin\"; pluginId: string; type: string; payload?: unknown; at?: string; journal?: ChatJournalCursor };\n\nlet keyCounter = 0;\n\n// crypto.randomUUID is missing outside secure contexts, e.g. for a host served over http.\nconst newKey = (): string => typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\"\n  ? crypto.randomUUID()\n  : `qsl-${Date.now().toString(36)}-${(keyCounter += 1).toString(36)}`;\n\nfunction openMessageIndex(messages: Message[]): number {\n  for (let index = messages.length - 1; index >= 0; index--) {\n    const message = messages[index];\n    if (!message.closed && (message.role === \"assistant\" || message.role === \"thinking\")) return index;\n  }\n  return -1;\n}\n\nfunction closeOpen(messages: Message[]): Message[] {\n  const index = openMessageIndex(messages);\n  if (index === -1) {\n    return messages;\n  }\n  return messages.map((message, position) => position === index ? { ...message, closed: true } : message);\n}\n\nfunction appendDelta(messages: Message[], role: Role, delta: string, at?: string, textCursor?: ChatTextCursor): Message[] {\n  const index = openMessageIndex(messages);\n  const current = messages[index];\n  if (current && current.role === role\n    && current.textCursor?.conversationId === textCursor?.conversationId\n    && current.textCursor?.sequence === textCursor?.sequence) {\n    return messages.map((message, position) => position === index\n      ? { ...message, text: message.text + delta, ...(textCursor ? { textCursor } : {}) }\n      : message);\n  }\n  return [...closeOpen(messages), { key: newKey(), role, text: delta, at, ...(textCursor ? { textCursor } : {}) }];\n}\n\n/** Incoming messages leave the running output block open. */\nexport function applyEvent(messages: Message[], event: ChatEvent): Message[] {\n  switch (event.kind) {\n    case \"reset\":\n      return [];\n    case \"user\":\n      return [...messages, { key: newKey(), role: \"user\", text: event.text, closed: true, at: event.at,\n        ...(event.inputId ? { inputId: event.inputId } : {}),\n        ...(event.attachments?.length ? { attachments: event.attachments } : {}) }];\n    case \"steered\":\n      return messages.map((message) => message.inputId === event.inputId ? { ...message, steered: true } : message);\n    case \"text\":\n      return appendDelta(messages, \"assistant\", event.delta, event.at, event.cursor);\n    case \"thinking\":\n      return appendDelta(messages, \"thinking\", event.delta, event.at);\n    case \"tool\":\n      return [\n        ...closeOpen(messages),\n        {\n          key: newKey(),\n          role: \"tool\",\n          text: event.label ?? event.name,\n          closed: true,\n          tool: { id: event.id, name: event.name, arguments: event.arguments },\n          at: event.at,\n        },\n      ];\n    case \"tool-result\": {\n      const index = messages.map((message) => message.tool?.id).lastIndexOf(event.id);\n      return messages.map((message, position) =>\n        position === index && message.tool\n          ? { ...message, tool: { ...message.tool, result: event.result, isError: event.isError } }\n          : message,\n      );\n    }\n    case \"action\":\n      return [\n        ...closeOpen(messages),\n        {\n          key: newKey(),\n          role: \"action\",\n          text: event.text,\n          closed: true,\n          action: { actionId: event.actionId, owner: event.owner, payload: event.payload },\n          at: event.at,\n        },\n      ];\n    case \"action-resolved\":\n      return messages.map((message) =>\n        message.action?.actionId === event.actionId\n          ? { ...message, action: { ...message.action, status: event.status, result: event.result } }\n          : message,\n      );\n    case \"system\":\n      return [...closeOpen(messages), { key: newKey(), role: \"system\", text: event.text, closed: true, at: event.at }];\n    case \"turn-done\":\n      return closeOpen(messages);\n    default:\n      return messages;\n  }\n}\n\nexport function prettyJson(value: string): string {\n  try {\n    return JSON.stringify(JSON.parse(value), null, 2);\n  } catch {\n    return value;\n  }\n}\n\nexport function compactToolLine(tool: ToolInfo): string {\n  const args = tool.arguments.replace(/\\s+/g, \" \").trim();\n  const line = args && args !== \"{}\" ? `${tool.name} ${args}` : tool.name;\n  return line.length > 160 ? `${line.slice(0, 160)} ...` : line;\n}\n\nexport { MAX_CHAT_ATTACHMENTS, MAX_CHAT_ATTACHMENT_BYTES, MAX_CHAT_REQUEST_BYTES, chatAttachmentMediaType, parseChatAttachments } from \"./chat-attachments\";\n"],
+  "mappings": "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",
+  "names": []
+}

package/elapsed.d.ts

@@ -0,0 +1,16 @@
+import { type ChatTexts } from "./texts";
+/** Under a minute "{seconds} s" from texts, then m:ss, from an hour on h:mm:ss. */
+export declare function formatElapsed(ms: number, texts: Pick<ChatTexts, "toolElapsedSeconds">): string;
+/** One interval for every subscriber; it runs only while someone listens. */
+export declare function createTicker(intervalMs?: number): {
+    subscribe(listener: () => void): () => void;
+    now(): number;
+    active: () => boolean;
+};
+export declare const elapsedTicker: {
+    subscribe(listener: () => void): () => void;
+    now(): number;
+    active: () => boolean;
+};
+/** Milliseconds since start in whole seconds, so a row renders only when its display changes; undefined on the server. */
+export declare function useElapsed(start: number): number | undefined;

package/events.d.ts

@@ -33,8 +33,8 @@ export interface ChatJournalCursor {
     sequence: number;
 }
 /**
- * Eine Aktion, die auf eine Eingabe des Benutzers wartet. Form und Inhalt von `payload` und
- * `result` gehören dem Plugin in `owner`; `status` gesetzt heißt: erledigt, die Karte ist Beleg.
+ * An action waiting for input from the user. Shape and content of `payload` and `result`
+ * belong to the plugin in `owner`; a set `status` means: done, the card is a record.
  */
 export interface PendingAction {
     actionId: string;
@@ -46,7 +46,7 @@ export interface PendingAction {
 export interface Message {
     key: string;
     role: Role;
-    /** Absenderkennung für die Darstellung; unabhängig von Rolle und Sprechblasenlabel. */
+    /** Sender identifier for display; independent of role and bubble label. */
     sender?: string;
     text: string;
     textCursor?: ChatTextCursor;
@@ -54,13 +54,13 @@ export interface Message {
     attachments?: ChatAttachment[];
     tool?: ToolInfo;
     action?: PendingAction;
-    /** ISO-Zeitpunkt der Nachricht; Anzeige optional (ChatMessages showTimestamps). */
+    /** ISO timestamp of the message; display optional (ChatMessages showTimestamps). */
     at?: string;
-    /** Der ActorInput hinter einer eingehenden Nachricht; an ihm hängt die Steering-Markierung. */
+    /** The ActorInput behind an incoming message; the steering mark hangs on it. */
     inputId?: string;
-    /** Die Nachricht ist in einen schon laufenden Turn eingespeist worden, statt einen eigenen zu beginnen. */
+    /** The message was fed into an already running turn instead of starting its own. */
     steered?: boolean;
-    /** Farbige Sprechblase statt Fliesstext, z.B. fuer Mehrparteien-Gespraeche. */
+    /** Colored speech bubble instead of running text, e.g. for multi-party conversations. */
     bubble?: {
         color: string;
         side: "start" | "end";
@@ -138,7 +138,7 @@ export type ChatEvent = {
     at?: string;
     journal?: ChatJournalCursor;
 };
-/** Eingehende Nachrichten lassen den laufenden Ausgabeblock offen. */
+/** Incoming messages leave the running output block open. */
 export declare function applyEvent(messages: Message[], event: ChatEvent): Message[];
 export declare function prettyJson(value: string): string;
 export declare function compactToolLine(tool: ToolInfo): string;

package/events.js

@@ -7,7 +7,7 @@ import {
   compactToolLine,
   parseChatAttachments,
   prettyJson
-} from "./chunk-IGCFQJZB.js";
+} from "./chunk-3VEL4HEO.js";
 export {
   MAX_CHAT_ATTACHMENTS,
   MAX_CHAT_ATTACHMENT_BYTES,

package/index.d.ts

@@ -17,6 +17,7 @@ export { useChatAction, copyChatText } from "./useChatAction";
 export { createChatScroll } from "./chat-scroll";
 export { ChatSendContext, createChatSendScope, type ChatSendScope } from "./ChatSendContext";
 export { messageDate, timestampDay, timestampLabel } from "./timestamps";
+export { formatElapsed, useElapsed } from "./elapsed";
 export { attachmentCapabilityError, attachmentDownloadUrl, attachmentMediaType, encodeAttachment, formatAttachmentSize, validateAttachmentSelection, MAX_CHAT_ATTACHMENTS, MAX_CHAT_ATTACHMENT_BYTES, } from "./attachments";
 export type { ChatAppearance, TimestampOptions, CodeBlockOptions, BubbleOptions, MessageAction, MessageActionsOptions, SendShortcut, } from "./options";
 export { appearanceStyle } from "./options";