@marinoscar/platform-web 0.0.0-stage → 0.1.0-next.4

package/dist/ai/ui/shared/AiImageGallery.js

@@ -0,0 +1,63 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The images an AI image run created — issue #445 (Image mode, #437 API).
+ *
+ * A succeeded image run's output names STORAGE OBJECTS the caller owns, never
+ * bytes or provider URLs. Each tile asks `GET /storage/objects/:id/download`
+ * for a short-lived signed URL and shows the image from it, with a Download
+ * link to the same URL. The URL is held in component state only.
+ *
+ * ACCESSIBILITY. Every image's alt text is the prompt that produced it (plus
+ * its position when there are several), so a screen-reader user hears what
+ * was asked for — the one description of the picture this page has.
+ */
+import { useEffect, useState } from 'react';
+import { Alert, Box, Button, Paper, Skeleton, Typography } from '@mui/material';
+import { Download as DownloadIcon } from '@mui/icons-material';
+import { useAiStorageObjects } from '../../headless/use-ai-storage.js';
+import { isPlatformApiError } from '../../../core/index.js';
+import { useIsMounted } from '../../internal/use-is-mounted.js';
+/** The alt text for image `index` of `count` made from `prompt`. */
+export function aiImageAltText(prompt, index, count) {
+    const text = prompt.trim() || 'AI-generated image';
+    return count > 1 ? `${text} (image ${index + 1} of ${count})` : text;
+}
+function extensionFor(mimeType) {
+    const subtype = mimeType.split('/')[1] ?? 'png';
+    return subtype === 'jpeg' ? 'jpg' : subtype;
+}
+export function AiImageTile({ storageObjectId, mimeType, alt, index, revisedPrompt }) {
+    const [url, setUrl] = useState(null);
+    const [error, setError] = useState(null);
+    const isMounted = useIsMounted();
+    const objects = useAiStorageObjects();
+    useEffect(() => {
+        setUrl(null);
+        setError(null);
+        void (async () => {
+            try {
+                const signed = await objects.downloadUrl(storageObjectId);
+                if (isMounted())
+                    setUrl(signed.url);
+            }
+            catch (err) {
+                if (isMounted())
+                    setError(isPlatformApiError(err) ? err.message : 'Could not load this image');
+            }
+        })();
+    }, [objects, storageObjectId, isMounted]);
+    return (_jsxs(Paper, { variant: "outlined", component: "figure", sx: { m: 0, p: 1, display: 'flex', flexDirection: 'column', gap: 1, minWidth: 0 }, children: [error ? (_jsx(Alert, { severity: "error", children: error })) : url ? (_jsx(Box, { component: "img", src: url, alt: alt, loading: "lazy", sx: { width: '100%', height: 'auto', display: 'block', borderRadius: 1, bgcolor: 'action.hover' } })) : (_jsx(Skeleton, { variant: "rectangular", sx: { width: '100%', aspectRatio: '1 / 1', height: 'auto' }, "aria-label": "Loading image" })), _jsxs(Box, { component: "figcaption", sx: { display: 'flex', alignItems: 'center', gap: 1, flexWrap: 'wrap' }, children: [revisedPrompt && (_jsxs(Typography, { variant: "caption", color: "text.secondary", sx: { flex: 1, minWidth: 0, wordBreak: 'break-word' }, children: ["Revised prompt: ", revisedPrompt] })), _jsx(Box, { sx: { flex: revisedPrompt ? 0 : 1 } }), _jsx(Button, { size: "small", startIcon: _jsx(DownloadIcon, {}), component: "a", href: url ?? undefined, download: `ai-image-${index + 1}.${extensionFor(mimeType)}`, target: "_blank", rel: "noopener noreferrer", disabled: !url, "aria-label": `Download image ${index + 1}`, children: "Download" })] })] }));
+}
+export function AiImageGallery({ output, prompt }) {
+    const count = output.images.length;
+    if (count === 0) {
+        return _jsx(Alert, { severity: "info", children: "The run finished without returning any images." });
+    }
+    return (_jsx(Box, { role: "list", "aria-label": "Generated images", sx: {
+            display: 'grid',
+            gridTemplateColumns: { xs: '1fr', sm: count > 1 ? 'repeat(2, minmax(0, 1fr))' : '1fr' },
+            gap: 2,
+        }, children: output.images.map((image, index) => (_jsx(Box, { role: "listitem", sx: { minWidth: 0 }, children: _jsx(AiImageTile, { storageObjectId: image.storageObjectId, mimeType: image.mimeType, alt: aiImageAltText(prompt, index, count), index: index, revisedPrompt: image.revisedPrompt }) }, image.storageObjectId))) }));
+}
+export default AiImageGallery;
+//# sourceMappingURL=AiImageGallery.js.map

package/dist/ai/ui/shared/AiImageGallery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiImageGallery.js","sourceRoot":"","sources":["../../../../src/ai/ui/shared/AiImageGallery.tsx"],"names":[],"mappings":"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"}

package/dist/ai/ui/shared/AiModelSelect.d.ts

@@ -0,0 +1,22 @@
+import type { UsableAiModel } from '../../headless/types.js';
+/** Stable key for a provider/model pair. */
+export declare function aiModelKey(model: {
+    provider: string;
+    modelId: string;
+}): string;
+export declare function aiModelLabel(model: UsableAiModel): string;
+export declare function hasAiCapability(model: UsableAiModel | null | undefined, capability: string): boolean;
+/** Why a model cannot be picked for `capability`, or `null` when it can. */
+export declare function aiModelDisabledReason(model: UsableAiModel, capability?: string): string | null;
+export interface AiModelSelectProps {
+    models: UsableAiModel[];
+    /** {@link aiModelKey} of the selection, or `''`. */
+    value: string;
+    onChange: (key: string) => void;
+    disabled?: boolean;
+    /** The capability a model needs to be pickable. Defaults to `responses`. */
+    capability?: string;
+}
+export declare function AiModelSelect({ models, value, onChange, disabled, capability }: AiModelSelectProps): import("react").JSX.Element;
+export default AiModelSelect;
+//# sourceMappingURL=AiModelSelect.d.ts.map

package/dist/ai/ui/shared/AiModelSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiModelSelect.d.ts","sourceRoot":"","sources":["../../../../src/ai/ui/shared/AiModelSelect.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAkB7D,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE/E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEzD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAEpG;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,SAAc,GAAG,MAAM,GAAG,IAAI,CAInG;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAwB,EAAE,EAAE,kBAAkB,+BAgDhH;AAED,eAAe,aAAa,CAAC"}

package/dist/ai/ui/shared/AiModelSelect.js

@@ -0,0 +1,61 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Model picker over `GET /api/ai/models` — issue #434, epic #419.
+ *
+ * Presentational: the page loads the usable models (they also drive which
+ * controls it shows and its empty state) and passes them in. Every model
+ * passed is listed; one that lacks `capability` (the playground mode's
+ * capability, #445 — `responses` by default) is shown DISABLED with the
+ * reason, rather than hidden. The playground itself passes only the models
+ * its current mode can use, so this is defence for any other caller.
+ */
+import { Box, ListItemText, MenuItem, TextField, Typography } from '@mui/material';
+import { AiCapabilityChips } from './AiCapabilityChips.js';
+import { aiCapabilityLabel } from './aiCapabilities.js';
+/** Whose key pays, as a menu line says it. `'none'` (#448) is a keyless server. */
+const KEY_SOURCE_SHORT = {
+    user: 'your key',
+    org: 'organisation key',
+    none: 'no key needed',
+};
+/** Whose key pays, as the caption under the selection says it. */
+const KEY_SOURCE_BILLING = {
+    user: 'billed to your key',
+    org: 'billed to the organisation key',
+    none: 'keyless server — no key is billed',
+};
+/** Stable key for a provider/model pair. */
+export function aiModelKey(model) {
+    return `${model.provider}:${model.modelId}`;
+}
+export function aiModelLabel(model) {
+    return model.displayName || model.modelId;
+}
+export function hasAiCapability(model, capability) {
+    return model?.capabilities.capabilities.includes(capability) ?? false;
+}
+/** Why a model cannot be picked for `capability`, or `null` when it can. */
+export function aiModelDisabledReason(model, capability = 'responses') {
+    if (hasAiCapability(model, capability))
+        return null;
+    if (capability === 'responses')
+        return 'Does not support text responses';
+    return `Does not support ${aiCapabilityLabel(capability).toLowerCase()}`;
+}
+export function AiModelSelect({ models, value, onChange, disabled, capability = 'responses' }) {
+    const selected = models.find((model) => aiModelKey(model) === value) ?? null;
+    return (_jsxs(Box, { children: [_jsx(TextField, { select: true, fullWidth: true, size: "small", label: "Model", value: selected ? value : '', onChange: (event) => onChange(event.target.value), disabled: disabled, slotProps: {
+                    select: {
+                        renderValue: (key) => {
+                            const model = models.find((entry) => aiModelKey(entry) === key);
+                            return model ? aiModelLabel(model) : '';
+                        },
+                    },
+                }, children: models.map((model) => {
+                    const reason = aiModelDisabledReason(model, capability);
+                    return (_jsx(MenuItem, { value: aiModelKey(model), disabled: reason !== null, children: _jsx(ListItemText, { primary: aiModelLabel(model), secondary: reason ??
+                                `${model.provider} · ${KEY_SOURCE_SHORT[model.keySource] ?? 'your key'}` }) }, aiModelKey(model)));
+                }) }), selected && (_jsxs(Box, { sx: { mt: 1 }, children: [_jsxs(Typography, { variant: "caption", color: "text.secondary", component: "p", sx: { mb: 0.5 }, children: [selected.provider, " \u00B7 ", selected.modelId, " \u00B7", ' ', KEY_SOURCE_BILLING[selected.keySource] ?? 'billed to your key'] }), _jsx(AiCapabilityChips, { capabilities: selected.capabilities.capabilities })] }))] }));
+}
+export default AiModelSelect;
+//# sourceMappingURL=AiModelSelect.js.map

package/dist/ai/ui/shared/AiModelSelect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiModelSelect.js","sourceRoot":"","sources":["../../../../src/ai/ui/shared/AiModelSelect.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,mFAAmF;AACnF,MAAM,gBAAgB,GAA2B;IAC/C,IAAI,EAAE,UAAU;IAChB,GAAG,EAAE,kBAAkB;IACvB,IAAI,EAAE,eAAe;CACtB,CAAC;AAEF,kEAAkE;AAClE,MAAM,kBAAkB,GAA2B;IACjD,IAAI,EAAE,oBAAoB;IAC1B,GAAG,EAAE,gCAAgC;IACrC,IAAI,EAAE,mCAAmC;CAC1C,CAAC;AAEF,4CAA4C;AAC5C,MAAM,UAAU,UAAU,CAAC,KAA4C;IACrE,OAAO,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAoB;IAC/C,OAAO,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAuC,EAAE,UAAkB;IACzF,OAAO,KAAK,EAAE,YAAY,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;AACxE,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,qBAAqB,CAAC,KAAoB,EAAE,UAAU,GAAG,WAAW;IAClF,IAAI,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,iCAAiC,CAAC;IACzE,OAAO,oBAAoB,iBAAiB,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;AAC3E,CAAC;AAYD,MAAM,UAAU,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,GAAG,WAAW,EAAsB;IAC/G,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC;IAE7E,OAAO,CACL,MAAC,GAAG,eACF,KAAC,SAAS,IACR,MAAM,QACN,SAAS,QACT,IAAI,EAAC,OAAO,EACZ,KAAK,EAAC,OAAO,EACb,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAC5B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EACjD,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE;oBACT,MAAM,EAAE;wBACN,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE;4BACnB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;4BAChE,OAAO,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC1C,CAAC;qBACF;iBACF,YAEA,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;oBACpB,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;oBACxD,OAAO,CACL,KAAC,QAAQ,IAAyB,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,YACnF,KAAC,YAAY,IACX,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,EAC5B,SAAS,EACP,MAAM;gCACN,GAAG,KAAK,CAAC,QAAQ,MAAM,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,UAAU,EAAE,GAE1E,IAPW,UAAU,CAAC,KAAK,CAAC,CAQrB,CACZ,CAAC;gBACJ,CAAC,CAAC,GACQ,EACX,QAAQ,IAAI,CACX,MAAC,GAAG,IAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,aAChB,MAAC,UAAU,IAAC,OAAO,EAAC,SAAS,EAAC,KAAK,EAAC,gBAAgB,EAAC,SAAS,EAAC,GAAG,EAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,aAC/E,QAAQ,CAAC,QAAQ,cAAK,QAAQ,CAAC,OAAO,aAAI,GAAG,EAC7C,kBAAkB,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,oBAAoB,IACpD,EACb,KAAC,iBAAiB,IAAC,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,YAAY,GAAI,IACnE,CACP,IACG,CACP,CAAC;AACJ,CAAC;AAED,eAAe,aAAa,CAAC"}

package/dist/ai/ui/shared/AiReasoningPanel.d.ts

@@ -0,0 +1,9 @@
+export interface AiReasoningPanelProps {
+    text: string;
+    /** True while the summary is still arriving. */
+    streaming?: boolean;
+    defaultExpanded?: boolean;
+}
+export declare function AiReasoningPanel({ text, streaming, defaultExpanded }: AiReasoningPanelProps): import("react").JSX.Element;
+export default AiReasoningPanel;
+//# sourceMappingURL=AiReasoningPanel.d.ts.map

package/dist/ai/ui/shared/AiReasoningPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiReasoningPanel.d.ts","sourceRoot":"","sources":["../../../../src/ai/ui/shared/AiReasoningPanel.tsx"],"names":[],"mappings":"AAaA,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,CAAC,EAAE,IAAI,EAAE,SAAiB,EAAE,eAAsB,EAAE,EAAE,qBAAqB,+BAkC1G;AAED,eAAe,gBAAgB,CAAC"}

package/dist/ai/ui/shared/AiReasoningPanel.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * A collapsible reasoning summary — issue #434, epic #419.
+ *
+ * Fed by `reasoning_summary.delta` frames as they stream, so it grows in step
+ * with the answer. Only a SUMMARY of the model's reasoning is ever shown —
+ * that is all a provider returns, and all the request asks for
+ * (`reasoning.summary`). Starts expanded; the toggle is a real button with
+ * `aria-expanded`, so it works from the keyboard and reads correctly.
+ */
+import { useId, useState } from 'react';
+import { Box, Button, CircularProgress, Collapse, Typography } from '@mui/material';
+import { ExpandLess as ExpandLessIcon, ExpandMore as ExpandMoreIcon } from '@mui/icons-material';
+export function AiReasoningPanel({ text, streaming = false, defaultExpanded = true }) {
+    const [expanded, setExpanded] = useState(defaultExpanded);
+    const regionId = useId();
+    return (_jsxs(Box, { sx: { borderLeft: 3, borderColor: 'divider', pl: 1.5, mb: 1, minWidth: 0 }, "data-testid": "reasoning-panel", children: [_jsx(Button, { size: "small", color: "inherit", onClick: () => setExpanded((open) => !open), "aria-expanded": expanded, "aria-controls": regionId, endIcon: expanded ? _jsx(ExpandLessIcon, {}) : _jsx(ExpandMoreIcon, {}), startIcon: streaming ? _jsx(CircularProgress, { size: 12, "aria-hidden": true }) : undefined, sx: { px: 0.5, textTransform: 'none', color: 'text.secondary' }, children: "Reasoning summary" }), _jsx(Collapse, { in: expanded, id: regionId, children: _jsx(Typography, { variant: "body2", color: "text.secondary", component: "div", "data-testid": "reasoning-text", sx: { whiteSpace: 'pre-wrap', wordBreak: 'break-word', pt: 0.5 }, children: text }) })] }));
+}
+export default AiReasoningPanel;
+//# sourceMappingURL=AiReasoningPanel.js.map

package/dist/ai/ui/shared/AiReasoningPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiReasoningPanel.js","sourceRoot":"","sources":["../../../../src/ai/ui/shared/AiReasoningPanel.tsx"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AASjG,MAAM,UAAU,gBAAgB,CAAC,EAAE,IAAI,EAAE,SAAS,GAAG,KAAK,EAAE,eAAe,GAAG,IAAI,EAAyB;IACzG,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC;IAEzB,OAAO,CACL,MAAC,GAAG,IACF,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,iBAC9D,iBAAiB,aAE7B,KAAC,MAAM,IACL,IAAI,EAAC,OAAO,EACZ,KAAK,EAAC,SAAS,EACf,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,mBAC5B,QAAQ,mBACR,QAAQ,EACvB,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAC,cAAc,KAAG,CAAC,CAAC,CAAC,KAAC,cAAc,KAAG,EAC3D,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,KAAC,gBAAgB,IAAC,IAAI,EAAE,EAAE,wBAAgB,CAAC,CAAC,CAAC,SAAS,EAC7E,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,kCAGxD,EACT,KAAC,QAAQ,IAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,YAClC,KAAC,UAAU,IACT,OAAO,EAAC,OAAO,EACf,KAAK,EAAC,gBAAgB,EACtB,SAAS,EAAC,KAAK,iBACH,gBAAgB,EAC5B,EAAE,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE,GAAG,EAAE,YAE/D,IAAI,GACM,GACJ,IACP,CACP,CAAC;AACJ,CAAC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/ai/ui/shared/AiRunCard.d.ts

@@ -0,0 +1,38 @@
+/**
+ * A background run's status card — issue #434, epic #419.
+ *
+ * Shows the prompt, the run's status as it is polled, and a Cancel button
+ * while the run can still be stopped. A successful run's answer is appended to
+ * the conversation by the page; this card only says so. A failed run renders
+ * its `errorCode` through the shared {@link AiErrorAlert} mapping.
+ *
+ * A `stale` run (#509) — its latest status read failed — is shown as the last
+ * KNOWN status, not the current one: the chip is outlined and labelled
+ * "(last known)", and while the hook is still retrying a quiet "Reconnecting…"
+ * line replaces any error banner. Only when the hook gives up does `error`
+ * render, still beside the stale chip rather than a live-looking badge.
+ *
+ * Every run-backed Playground mode reuses it (#445): `title` names the run
+ * ("Image run") and `successMessage` says where its result went.
+ */
+import type { ReactNode } from 'react';
+import type { AiRun } from '../../headless/types.js';
+import type { AiErrorInfo } from '../../headless/errors.js';
+export interface AiRunCardProps {
+    prompt: string;
+    run: AiRun | null;
+    error: AiErrorInfo | null;
+    isStarting: boolean;
+    isCancelling: boolean;
+    onCancel: () => void;
+    onDismiss: () => void;
+    /** The card's heading and accessible name. Defaults to "Background run". */
+    title?: string;
+    /** The latest status read failed; `run` is the last known state (#509). */
+    stale?: boolean;
+    /** Shown once the run succeeds; `null` shows nothing. */
+    successMessage?: ReactNode;
+}
+export declare function AiRunCard({ prompt, run, error, isStarting, isCancelling, onCancel, onDismiss, stale, title, successMessage, }: AiRunCardProps): import("react").JSX.Element;
+export default AiRunCard;
+//# sourceMappingURL=AiRunCard.d.ts.map

package/dist/ai/ui/shared/AiRunCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiRunCard.d.ts","sourceRoot":"","sources":["../../../../src/ai/ui/shared/AiRunCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAY5D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;IAClB,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yDAAyD;IACzD,cAAc,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED,wBAAgB,SAAS,CAAC,EACxB,MAAM,EACN,GAAG,EACH,KAAK,EACL,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,KAAa,EACb,KAAwB,EACxB,cAA4D,GAC7D,EAAE,cAAc,+BAgEhB;AAED,eAAe,SAAS,CAAC"}

package/dist/ai/ui/shared/AiRunCard.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Button, Chip, CircularProgress, Paper, Typography } from '@mui/material';
+import { isAiRunTerminal } from '../../headless/use-ai-run.js';
+import { AiErrorAlert } from './AiErrorAlert.js';
+const STATUS = {
+    pending: { label: 'Queued', color: 'default' },
+    running: { label: 'Running', color: 'info' },
+    succeeded: { label: 'Succeeded', color: 'success' },
+    failed: { label: 'Failed', color: 'error' },
+    cancelled: { label: 'Cancelled', color: 'warning' },
+};
+export function AiRunCard({ prompt, run, error, isStarting, isCancelling, onCancel, onDismiss, stale = false, title = 'Background run', successMessage = 'The answer was added to the conversation.', }) {
+    const status = run?.status ?? 'pending';
+    const terminal = run ? isAiRunTerminal(run.status) : false;
+    const settledOrBroken = terminal || (error !== null && !isStarting);
+    const meta = STATUS[status];
+    const reconnecting = stale && !error && !terminal;
+    return (_jsxs(Paper, { variant: "outlined", sx: { p: 1.5, minWidth: 0 }, "aria-label": title, role: "region", children: [_jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 1, flexWrap: 'wrap' }, children: [_jsx(Typography, { variant: "subtitle2", component: "h2", children: title }), !error || run ? (_jsx(Chip, { size: "small", label: isStarting ? 'Starting' : stale ? `${meta.label} (last known)` : meta.label, color: stale ? 'default' : meta.color, variant: stale ? 'outlined' : 'filled', "data-testid": "run-status" })) : null, !settledOrBroken && _jsx(CircularProgress, { size: 14, "aria-label": "Waiting for the run" }), _jsx(Box, { sx: { flex: 1 } }), !settledOrBroken && !isStarting && (_jsx(Button, { size: "small", color: "inherit", onClick: onCancel, disabled: isCancelling, children: isCancelling ? 'Cancelling…' : 'Cancel run' })), settledOrBroken && (_jsx(Button, { size: "small", color: "inherit", onClick: onDismiss, children: "Dismiss" }))] }), _jsx(Typography, { variant: "body2", color: "text.secondary", sx: { mt: 0.5, whiteSpace: 'pre-wrap', wordBreak: 'break-word' }, children: prompt }), reconnecting && (_jsx(Typography, { variant: "caption", color: "text.secondary", role: "status", sx: { display: 'block', mt: 0.5 }, children: "Reconnecting\u2026 the status shown may be out of date." })), status === 'succeeded' && successMessage !== null && (_jsx(Typography, { variant: "body2", sx: { mt: 1 }, children: successMessage })), status === 'failed' && run && (_jsx(Box, { sx: { mt: 1 }, children: _jsx(AiErrorAlert, { error: { code: run.errorCode, message: run.errorMessage ?? 'The run failed.' } }) })), error && (_jsx(Box, { sx: { mt: 1 }, children: _jsx(AiErrorAlert, { error: error }) }))] }));
+}
+export default AiRunCard;
+//# sourceMappingURL=AiRunCard.js.map

package/dist/ai/ui/shared/AiRunCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiRunCard.js","sourceRoot":"","sources":["../../../../src/ai/ui/shared/AiRunCard.tsx"],"names":[],"mappings":"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"}

package/dist/ai/ui/shared/AiSpeechPlayer.d.ts

@@ -0,0 +1,9 @@
+import type { AiSpeechRunOutput } from '../../headless/types.js';
+export declare const AI_GENERATED_AUDIO_LABEL = "AI-generated audio";
+export declare const AI_SPEECH_PLAYBACK_FAILED_MESSAGE = "This audio could not be played in the browser. Use Download audio to listen to it.";
+export interface AiSpeechPlayerProps {
+    output: AiSpeechRunOutput;
+}
+export declare function AiSpeechPlayer({ output }: AiSpeechPlayerProps): import("react").JSX.Element;
+export default AiSpeechPlayer;
+//# sourceMappingURL=AiSpeechPlayer.d.ts.map

package/dist/ai/ui/shared/AiSpeechPlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiSpeechPlayer.d.ts","sourceRoot":"","sources":["../../../../src/ai/ui/shared/AiSpeechPlayer.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAKjE,eAAO,MAAM,wBAAwB,uBAAuB,CAAC;AAC7D,eAAO,MAAM,iCAAiC,uFACwC,CAAC;AAEvF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,EAAE,mBAAmB,+BAuE7D;AAED,eAAe,cAAc,CAAC"}

package/dist/ai/ui/shared/AiSpeechPlayer.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * A speech run's audio — issue #445 (API #439, docs/specs/ai-platform.md §2.14).
+ *
+ * The audio is a storage object the caller owns; it plays from a short-lived
+ * signed URL (`GET /storage/objects/:id/download`, held in state only) in a
+ * native, labelled `<audio controls>` player, with a download link. A media
+ * load failure (a CSP block, an expired URL — issue #510) is explained with a
+ * warning pointing at the download link, rather than leaving a dead 0:00 player.
+ *
+ * DISCLOSURE. Provider usage policies require telling listeners that a voice
+ * is AI-generated, and every speech output carries `aiGenerated: true`. The
+ * "AI-generated audio" label is therefore always visible beside the player
+ * and part of the player's accessible name — not a tooltip, not optional.
+ */
+import { useEffect, useState } from 'react';
+import { Alert, Box, Button, Chip, Paper, Skeleton, Typography } from '@mui/material';
+import { Download as DownloadIcon, SmartToy as AiIcon } from '@mui/icons-material';
+import { useAiStorageObjects } from '../../headless/use-ai-storage.js';
+import { isPlatformApiError } from '../../../core/index.js';
+import { useIsMounted } from '../../internal/use-is-mounted.js';
+export const AI_GENERATED_AUDIO_LABEL = 'AI-generated audio';
+export const AI_SPEECH_PLAYBACK_FAILED_MESSAGE = 'This audio could not be played in the browser. Use Download audio to listen to it.';
+export function AiSpeechPlayer({ output }) {
+    const [url, setUrl] = useState(null);
+    const [error, setError] = useState(null);
+    const [playbackFailed, setPlaybackFailed] = useState(false);
+    const isMounted = useIsMounted();
+    const objects = useAiStorageObjects();
+    useEffect(() => {
+        setUrl(null);
+        setError(null);
+        setPlaybackFailed(false);
+        void (async () => {
+            try {
+                const signed = await objects.downloadUrl(output.storageObjectId);
+                if (isMounted())
+                    setUrl(signed.url);
+            }
+            catch (err) {
+                if (isMounted())
+                    setError(isPlatformApiError(err) ? err.message : 'Could not load the audio');
+            }
+        })();
+    }, [objects, output.storageObjectId, isMounted]);
+    const accessibleName = `${AI_GENERATED_AUDIO_LABEL}, voice ${output.voice}`;
+    return (_jsxs(Paper, { variant: "outlined", component: "figure", "aria-label": "Generated speech", sx: { m: 0, p: 1.5, display: 'flex', flexDirection: 'column', gap: 1, minWidth: 0 }, children: [_jsxs(Box, { component: "figcaption", sx: { display: 'flex', alignItems: 'center', gap: 1, flexWrap: 'wrap' }, children: [_jsx(Chip, { icon: _jsx(AiIcon, {}), color: "secondary", size: "small", label: AI_GENERATED_AUDIO_LABEL }), _jsxs(Typography, { variant: "caption", color: "text.secondary", children: ["Voice ", output.voice, " \u00B7 ", output.format.toUpperCase(), " \u00B7 ", output.characters.toLocaleString(), " characters"] })] }), error ? (_jsx(Alert, { severity: "error", children: error })) : playbackFailed ? (_jsx(Alert, { severity: "warning", children: AI_SPEECH_PLAYBACK_FAILED_MESSAGE })) : url ? (_jsx(Box, { component: "audio", controls: true, src: url, "aria-label": accessibleName, preload: "metadata", onError: () => setPlaybackFailed(true), sx: { width: '100%' }, children: "Your browser cannot play this audio; use the download link." })) : (_jsx(Skeleton, { variant: "rounded", height: 40, "aria-label": "Loading audio" })), _jsx(Box, { children: _jsx(Button, { size: "small", startIcon: _jsx(DownloadIcon, {}), component: "a", href: url ?? undefined, download: `ai-speech.${output.format}`, target: "_blank", rel: "noopener noreferrer", disabled: !url, children: "Download audio" }) })] }));
+}
+export default AiSpeechPlayer;
+//# sourceMappingURL=AiSpeechPlayer.js.map

package/dist/ai/ui/shared/AiSpeechPlayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiSpeechPlayer.js","sourceRoot":"","sources":["../../../../src/ai/ui/shared/AiSpeechPlayer.tsx"],"names":[],"mappings":"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"}

package/dist/ai/ui/shared/AiStructuredOutputPanel.d.ts

@@ -0,0 +1,7 @@
+export interface AiStructuredOutputPanelProps {
+    parsed: unknown;
+    title?: string;
+}
+export declare function AiStructuredOutputPanel({ parsed, title }: AiStructuredOutputPanelProps): import("react").JSX.Element;
+export default AiStructuredOutputPanel;
+//# sourceMappingURL=AiStructuredOutputPanel.d.ts.map

package/dist/ai/ui/shared/AiStructuredOutputPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiStructuredOutputPanel.d.ts","sourceRoot":"","sources":["../../../../src/ai/ui/shared/AiStructuredOutputPanel.tsx"],"names":[],"mappings":"AAUA,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,uBAAuB,CAAC,EAAE,MAAM,EAAE,KAA2B,EAAE,EAAE,4BAA4B,+BAwB5G;AAED,eAAe,uBAAuB,CAAC"}

package/dist/ai/ui/shared/AiStructuredOutputPanel.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The parsed result of a structured-output request — issue #434, epic #419.
+ *
+ * Pretty-prints `AiResponse.parsed` — the value the API already validated
+ * against the requested JSON Schema (a failure there is
+ * `AI_STRUCTURED_OUTPUT_INVALID`, never a half-parsed object here). The block
+ * scrolls horizontally on its own so a long line never widens the page.
+ */
+import { Box, Typography } from '@mui/material';
+export function AiStructuredOutputPanel({ parsed, title = 'Structured output' }) {
+    return (_jsxs(Box, { sx: { mt: 1, minWidth: 0 }, "data-testid": "structured-output-panel", children: [_jsx(Typography, { variant: "overline", color: "text.secondary", component: "p", children: title }), _jsx(Box, { component: "pre", "aria-label": title, sx: {
+                    m: 0,
+                    p: 1.5,
+                    borderRadius: 1,
+                    bgcolor: 'action.hover',
+                    fontFamily: 'monospace',
+                    fontSize: '0.8125rem',
+                    overflowX: 'auto',
+                    maxWidth: '100%',
+                }, children: JSON.stringify(parsed, null, 2) })] }));
+}
+export default AiStructuredOutputPanel;
+//# sourceMappingURL=AiStructuredOutputPanel.js.map

package/dist/ai/ui/shared/AiStructuredOutputPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiStructuredOutputPanel.js","sourceRoot":"","sources":["../../../../src/ai/ui/shared/AiStructuredOutputPanel.tsx"],"names":[],"mappings":";AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAOhD,MAAM,UAAU,uBAAuB,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,mBAAmB,EAAgC;IAC3G,OAAO,CACL,MAAC,GAAG,IAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,iBAAc,yBAAyB,aACpE,KAAC,UAAU,IAAC,OAAO,EAAC,UAAU,EAAC,KAAK,EAAC,gBAAgB,EAAC,SAAS,EAAC,GAAG,YAChE,KAAK,GACK,EACb,KAAC,GAAG,IACF,SAAS,EAAC,KAAK,gBACH,KAAK,EACjB,EAAE,EAAE;oBACF,CAAC,EAAE,CAAC;oBACJ,CAAC,EAAE,GAAG;oBACN,YAAY,EAAE,CAAC;oBACf,OAAO,EAAE,cAAc;oBACvB,UAAU,EAAE,WAAW;oBACvB,QAAQ,EAAE,WAAW;oBACrB,SAAS,EAAE,MAAM;oBACjB,QAAQ,EAAE,MAAM;iBACjB,YAEA,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAC5B,IACF,CACP,CAAC;AACJ,CAAC;AAED,eAAe,uBAAuB,CAAC"}

package/dist/ai/ui/shared/AiTranscript.d.ts

@@ -0,0 +1,9 @@
+import type { AiTranscriptionRunOutput } from '../../headless/types.js';
+/** `m:ss` (or `h:mm:ss`) for a number of seconds. */
+export declare function formatTimestamp(seconds: number): string;
+export interface AiTranscriptProps {
+    output: AiTranscriptionRunOutput;
+}
+export declare function AiTranscript({ output }: AiTranscriptProps): import("react").JSX.Element;
+export default AiTranscript;
+//# sourceMappingURL=AiTranscript.d.ts.map

package/dist/ai/ui/shared/AiTranscript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiTranscript.d.ts","sourceRoot":"","sources":["../../../../src/ai/ui/shared/AiTranscript.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAExE,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,wBAAwB,CAAC;CAClC;AAED,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,iBAAiB,+BA6FzD;AAED,eAAe,YAAY,CAAC"}

package/dist/ai/ui/shared/AiTranscript.js

@@ -0,0 +1,38 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * A transcription run's result — issue #445 (API #438).
+ *
+ * The full text with a Copy button, the language and duration the provider
+ * reported, and — when the model produced them — the timestamped segments as
+ * an ordered list (`[0:04–0:09] text`). Everything is rendered as text.
+ */
+import { useState } from 'react';
+import { Box, Button, Chip, Paper, Stack, Typography } from '@mui/material';
+import { Check as CheckIcon, ContentCopy as CopyIcon } from '@mui/icons-material';
+/** `m:ss` (or `h:mm:ss`) for a number of seconds. */
+export function formatTimestamp(seconds) {
+    const total = Math.max(0, Math.floor(seconds));
+    const h = Math.floor(total / 3600);
+    const m = Math.floor((total % 3600) / 60);
+    const s = String(total % 60).padStart(2, '0');
+    return h > 0 ? `${h}:${String(m).padStart(2, '0')}:${s}` : `${m}:${s}`;
+}
+export function AiTranscript({ output }) {
+    const [copied, setCopied] = useState('idle');
+    const segments = output.segments ?? [];
+    // PP-14.17: what a provider reports beyond the neutral fields. Shown only when
+    // it carries speaker-labelled segments; any other extra is for the app to use.
+    const speakerSegments = output.extras?.segments ?? [];
+    const copy = async () => {
+        try {
+            await navigator.clipboard.writeText(output.text);
+            setCopied('copied');
+        }
+        catch {
+            setCopied('failed');
+        }
+    };
+    return (_jsx(Paper, { variant: "outlined", component: "section", "aria-label": "Transcript", sx: { p: 1.5, minWidth: 0 }, children: _jsxs(Stack, { spacing: 1.5, children: [_jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 1, flexWrap: 'wrap' }, children: [_jsx(Typography, { variant: "subtitle2", component: "h2", children: "Transcript" }), output.language && _jsx(Chip, { size: "small", label: `Language: ${output.language}` }), typeof output.durationSeconds === 'number' && (_jsx(Chip, { size: "small", label: `Duration: ${formatTimestamp(output.durationSeconds)}` })), _jsx(Box, { sx: { flex: 1 } }), _jsx(Button, { size: "small", startIcon: copied === 'copied' ? _jsx(CheckIcon, {}) : _jsx(CopyIcon, {}), onClick: () => void copy(), disabled: output.text === '', children: copied === 'copied' ? 'Copied' : 'Copy transcript' })] }), copied === 'failed' && (_jsx(Typography, { variant: "caption", color: "error", role: "alert", children: "Could not copy \u2014 select the text and copy it instead." })), _jsx(Typography, { variant: "body2", "data-testid": "transcript-text", sx: { whiteSpace: 'pre-wrap', wordBreak: 'break-word' }, children: output.text || 'No speech was recognised.' }), segments.length > 0 && (_jsx(Box, { component: "ol", "aria-label": "Segments", sx: { m: 0, pl: 0, listStyle: 'none' }, children: segments.map((segment, index) => (_jsxs(Box, { component: "li", sx: { display: 'flex', gap: 1.5, py: 0.25 }, children: [_jsxs(Typography, { component: "span", variant: "caption", color: "text.secondary", sx: { fontFamily: 'monospace', flexShrink: 0, pt: 0.25 }, children: [_jsx("time", { dateTime: `PT${segment.startSeconds}S`, children: formatTimestamp(segment.startSeconds) }), "\u2013", _jsx("time", { dateTime: `PT${segment.endSeconds}S`, children: formatTimestamp(segment.endSeconds) })] }), _jsx(Typography, { component: "span", variant: "body2", sx: { wordBreak: 'break-word' }, children: segment.text })] }, index))) })), speakerSegments.length > 0 && (_jsx(Box, { component: "ol", "aria-label": "Speakers", sx: { m: 0, pl: 0, listStyle: 'none' }, children: speakerSegments.map((segment, index) => (_jsxs(Box, { component: "li", sx: { display: 'flex', gap: 1.5, py: 0.25 }, children: [_jsxs(Typography, { component: "span", variant: "caption", color: "text.secondary", sx: { fontFamily: 'monospace', flexShrink: 0, pt: 0.25 }, children: [_jsx("time", { dateTime: `PT${segment.start}S`, children: formatTimestamp(segment.start) }), "\u2013", _jsx("time", { dateTime: `PT${segment.end}S`, children: formatTimestamp(segment.end) })] }), segment.speaker && _jsx(Chip, { size: "small", variant: "outlined", label: segment.speaker }), _jsx(Typography, { component: "span", variant: "body2", sx: { wordBreak: 'break-word' }, children: segment.text })] }, index))) }))] }) }));
+}
+export default AiTranscript;
+//# sourceMappingURL=AiTranscript.js.map

package/dist/ai/ui/shared/AiTranscript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AiTranscript.js","sourceRoot":"","sources":["../../../../src/ai/ui/shared/AiTranscript.tsx"],"names":[],"mappings":"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"}

package/dist/ai/ui/shared/aiCapabilities.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The AI capability vocabulary as the web app renders it — shared by every
+ * AI surface (issues #429, #430, #434; epic #419).
+ *
+ * The values mirror the API's permanent `BUILTIN_AI_CAPABILITIES`,
+ * `AI_INPUT_MODALITIES`, `AI_OUTPUT_MODALITIES` and `AI_REASONING_EFFORTS`
+ * (`apps/api/src/ai/core/capabilities.ts`). They are stored in the catalogue
+ * table and in administrator overrides, so they never change spelling — and
+ * no legacy alias is accepted here: a string the API does not emit is shown
+ * as itself, never silently mapped.
+ */
+/** The built-in capabilities. The vocabulary is open (PP-14.17): an app adds its own on the API. */
+export declare const AI_CAPABILITY_VALUES: readonly ["responses", "reasoning", "tools", "hosted_tools", "structured_output", "streaming", "vision_input", "file_input", "image_generation", "image_edit", "audio_transcription", "audio_speech", "embeddings", "realtime"];
+export declare const AI_INPUT_MODALITY_VALUES: readonly ["text", "image", "audio", "file"];
+export declare const AI_OUTPUT_MODALITY_VALUES: readonly ["text", "image", "audio", "embedding"];
+export declare const AI_REASONING_EFFORT_VALUES: readonly ["minimal", "low", "medium", "high"];
+/** One short, UNIQUE label per capability. */
+export declare const AI_CAPABILITY_LABELS: Record<string, string>;
+/**
+ * A capability's label: a built-in one's, else one the API reported or the app
+ * registered (`registerAiCapabilityLabel`, PP-14.17), else the id itself, so an
+ * unknown capability never vanishes.
+ */
+export declare function aiCapabilityLabel(capability: string): string;
+export interface AiCapabilityGroup {
+    id: string;
+    label: string;
+    members: readonly string[];
+}
+/**
+ * Nine families, for surfaces where fourteen chips per row would be
+ * unreadable (the admin catalogue): Text / Reasoning / Tools / Structured /
+ * Vision / Image / Audio / Embeddings / Realtime.
+ */
+export declare const AI_CAPABILITY_GROUPS: readonly AiCapabilityGroup[];
+/** The families a capability list covers, in display order, plus any unknown strings. */
+export declare function groupCapabilities(capabilities: readonly string[]): {
+    groups: {
+        group: AiCapabilityGroup;
+        present: string[];
+    }[];
+    unknown: string[];
+};
+/** Plain-text family summary — a table's CSV value and search text. */
+export declare function capabilitySummary(capabilities: readonly string[]): string;
+//# sourceMappingURL=aiCapabilities.d.ts.map

package/dist/ai/ui/shared/aiCapabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiCapabilities.d.ts","sourceRoot":"","sources":["../../../../src/ai/ui/shared/aiCapabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,oGAAoG;AACpG,eAAO,MAAM,oBAAoB,iOAevB,CAAC;AAEX,eAAO,MAAM,wBAAwB,6CAA8C,CAAC;AACpF,eAAO,MAAM,yBAAyB,kDAAmD,CAAC;AAC1F,eAAO,MAAM,0BAA0B,+CAAgD,CAAC;AAExF,8CAA8C;AAC9C,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAevD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,iBAAiB,EAU5D,CAAC;AAIF,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG;IAClE,MAAM,EAAE;QAAE,KAAK,EAAE,iBAAiB,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAOA;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAGzE"}