@stigmer/react 0.0.36 → 0.0.39

package/attachment/AttachmentChipList.d.ts

@@ -0,0 +1,24 @@
+import type { AttachmentEntry } from "./useAttachments";
+export interface AttachmentChipListProps {
+    /** Attachment entries from {@link useAttachments}. */
+    readonly entries: readonly AttachmentEntry[];
+    /** Remove callback (by entry ID). */
+    readonly onRemove: (id: string) => void;
+    /** Retry callback for failed uploads (by entry ID). */
+    readonly onRetry: (id: string) => void;
+    /** Disables remove and retry actions. */
+    readonly disabled?: boolean;
+    readonly className?: string;
+}
+/**
+ * Renders a horizontal list of compact attachment chips showing
+ * filename, size, upload status, and remove/retry actions.
+ *
+ * Designed to sit between the context chips and toolbar in
+ * {@link SessionComposer}, but usable standalone by platform builders
+ * who compose their own attachment UI.
+ *
+ * All visual properties flow through `--stgm-*` tokens.
+ */
+export declare function AttachmentChipList({ entries, onRemove, onRetry, disabled, className, }: AttachmentChipListProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=AttachmentChipList.d.ts.map

package/attachment/AttachmentChipList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttachmentChipList.d.ts","sourceRoot":"","sources":["../../src/attachment/AttachmentChipList.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,GACV,EAAE,uBAAuB,kDAoBzB"}

package/attachment/AttachmentChipList.js

@@ -0,0 +1,45 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "@stigmer/theme";
+import { formatFileSize } from "./attachment-utils";
+/**
+ * Renders a horizontal list of compact attachment chips showing
+ * filename, size, upload status, and remove/retry actions.
+ *
+ * Designed to sit between the context chips and toolbar in
+ * {@link SessionComposer}, but usable standalone by platform builders
+ * who compose their own attachment UI.
+ *
+ * All visual properties flow through `--stgm-*` tokens.
+ */
+export function AttachmentChipList({ entries, onRemove, onRetry, disabled, className, }) {
+    if (entries.length === 0)
+        return null;
+    return (_jsx("div", { className: cn("flex flex-wrap gap-1.5", className), role: "list", "aria-label": "Attached files", children: entries.map((entry) => (_jsx(AttachmentChip, { entry: entry, onRemove: () => onRemove(entry.id), onRetry: () => onRetry(entry.id), disabled: disabled }, entry.id))) }));
+}
+// ---------------------------------------------------------------------------
+// Individual chip
+// ---------------------------------------------------------------------------
+function AttachmentChip({ entry, onRemove, onRetry, disabled, }) {
+    const isError = entry.phase === "error";
+    const isUploading = entry.phase === "uploading";
+    return (_jsxs("span", { role: "listitem", "aria-label": `${entry.file.name}, ${formatFileSize(entry.file.size)}${isUploading ? ", uploading" : ""}${isError ? ", upload failed" : ""}`, className: cn("inline-flex max-w-[200px] items-center gap-1 rounded-md px-2 py-0.5 text-xs", isError
+            ? "border border-destructive/30 bg-destructive/10 text-destructive"
+            : "bg-muted/50 text-foreground", isUploading && "opacity-70"), children: [isUploading && _jsx(ChipSpinner, {}), isError && _jsx(ErrorDot, {}), !isUploading && !isError && _jsx(FileIcon, {}), _jsx("span", { className: "truncate", children: entry.file.name }), _jsx("span", { className: "shrink-0 text-[0.6rem] tabular-nums text-muted-foreground", children: formatFileSize(entry.file.size) }), isError && (_jsx("button", { type: "button", onClick: onRetry, disabled: disabled, className: "shrink-0 text-[0.6rem] font-medium text-destructive underline hover:text-destructive/80 disabled:pointer-events-none", "aria-label": `Retry uploading ${entry.file.name}`, children: "Retry" })), _jsx("button", { type: "button", onClick: onRemove, disabled: disabled, className: "ml-0.5 shrink-0 text-muted-foreground hover:text-destructive disabled:pointer-events-none", "aria-label": `Remove ${entry.file.name}`, children: _jsx(XIcon, {}) })] }));
+}
+// ---------------------------------------------------------------------------
+// Inline SVG icons — kept minimal and consistent with SessionComposer icons
+// ---------------------------------------------------------------------------
+function ChipSpinner() {
+    return (_jsx("svg", { width: "10", height: "10", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "2.5", strokeLinecap: "round", className: "shrink-0 animate-spin text-muted-foreground", "aria-hidden": "true", children: _jsx("path", { d: "M8 2a6 6 0 1 0 6 6" }) }));
+}
+function ErrorDot() {
+    return (_jsx("span", { className: "inline-block h-1.5 w-1.5 shrink-0 rounded-full bg-destructive", "aria-hidden": "true" }));
+}
+function FileIcon() {
+    return (_jsxs("svg", { width: "10", height: "10", viewBox: "0 0 14 14", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", className: "shrink-0 text-muted-foreground", "aria-hidden": "true", children: [_jsx("path", { d: "M8 1H4C3.45 1 3 1.45 3 2V12C3 12.55 3.45 13 4 13H10C10.55 13 11 12.55 11 12V4L8 1Z" }), _jsx("path", { d: "M8 1V4H11" })] }));
+}
+function XIcon() {
+    return (_jsx("svg", { width: "10", height: "10", viewBox: "0 0 14 14", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "M4 4L10 10M10 4L4 10" }) }));
+}
+//# sourceMappingURL=AttachmentChipList.js.map

package/attachment/AttachmentChipList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttachmentChipList.js","sourceRoot":"","sources":["../../src/attachment/AttachmentChipList.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAcpD;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,EACjC,OAAO,EACP,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,GACe;IACxB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,OAAO,CACL,cACE,SAAS,EAAE,EAAE,CAAC,wBAAwB,EAAE,SAAS,CAAC,EAClD,IAAI,EAAC,MAAM,gBACA,gBAAgB,YAE1B,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CACtB,KAAC,cAAc,IAEb,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAClC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,EAChC,QAAQ,EAAE,QAAQ,IAJb,KAAK,CAAC,EAAE,CAKb,CACH,CAAC,GACE,CACP,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,SAAS,cAAc,CAAC,EACtB,KAAK,EACL,QAAQ,EACR,OAAO,EACP,QAAQ,GAMT;IACC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC;IACxC,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,KAAK,WAAW,CAAC;IAEhD,OAAO,CACL,gBACE,IAAI,EAAC,UAAU,gBACH,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE,EAC1I,SAAS,EAAE,EAAE,CACX,6EAA6E,EAC7E,OAAO;YACL,CAAC,CAAC,iEAAiE;YACnE,CAAC,CAAC,6BAA6B,EACjC,WAAW,IAAI,YAAY,CAC5B,aAEA,WAAW,IAAI,KAAC,WAAW,KAAG,EAC9B,OAAO,IAAI,KAAC,QAAQ,KAAG,EACvB,CAAC,WAAW,IAAI,CAAC,OAAO,IAAI,KAAC,QAAQ,KAAG,EAEzC,eAAM,SAAS,EAAC,UAAU,YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAQ,EAEnD,eAAM,SAAS,EAAC,2DAA2D,YACxE,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAC3B,EAEN,OAAO,IAAI,CACV,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAC,sHAAsH,gBACpH,mBAAmB,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,sBAGzC,CACV,EAED,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,QAAQ,EACjB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAC,2FAA2F,gBACzF,UAAU,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,YAEvC,KAAC,KAAK,KAAG,GACF,IACJ,CACR,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAE9E,SAAS,WAAW;IAClB,OAAO,CACL,cACE,KAAK,EAAC,IAAI,EACV,MAAM,EAAC,IAAI,EACX,OAAO,EAAC,WAAW,EACnB,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,aAAa,EAAC,OAAO,EACrB,SAAS,EAAC,6CAA6C,iBAC3C,MAAM,YAElB,eAAM,CAAC,EAAC,oBAAoB,GAAG,GAC3B,CACP,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ;IACf,OAAO,CACL,eACE,SAAS,EAAC,+DAA+D,iBAC7D,MAAM,GAClB,CACH,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ;IACf,OAAO,CACL,eACE,KAAK,EAAC,IAAI,EACV,MAAM,EAAC,IAAI,EACX,OAAO,EAAC,WAAW,EACnB,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,EACtB,SAAS,EAAC,gCAAgC,iBAC9B,MAAM,aAElB,eAAM,CAAC,EAAC,oFAAoF,GAAG,EAC/F,eAAM,CAAC,EAAC,WAAW,GAAG,IAClB,CACP,CAAC;AACJ,CAAC;AAED,SAAS,KAAK;IACZ,OAAO,CACL,cACE,KAAK,EAAC,IAAI,EACV,MAAM,EAAC,IAAI,EACX,OAAO,EAAC,WAAW,EACnB,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,iBACV,MAAM,YAElB,eAAM,CAAC,EAAC,sBAAsB,GAAG,GAC7B,CACP,CAAC;AACJ,CAAC"}

package/attachment/attachment-utils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Maximum attachment size in bytes (10 MB).
+ *
+ * Matches the CLI's `maxAttachmentSize` and the gRPC server's
+ * `MaxRecvMsgSize`. Files exceeding this limit are rejected before
+ * upload to avoid wasting bandwidth on requests that will fail.
+ */
+export declare const MAX_ATTACHMENT_BYTES: number;
+/**
+ * Detects the MIME content type for a file.
+ *
+ * Prefers the browser-provided `File.type` when available and
+ * non-empty. Falls back to extension-based detection mirroring the
+ * CLI's `detectContentType` function. Returns
+ * `"application/octet-stream"` when neither source yields a result.
+ */
+export declare function detectContentType(file: File): string;
+/**
+ * Formats a byte count as a human-readable string (e.g., `"2.3 MB"`).
+ *
+ * Uses base-1024 (binary) units with one decimal place, consistent
+ * with {@link formatArtifactSize} in the artifact utilities.
+ */
+export declare function formatFileSize(bytes: number): string;
+/**
+ * Validates a file against the attachment size limit.
+ *
+ * Returns `null` when valid, or an error message string when the
+ * file exceeds {@link MAX_ATTACHMENT_BYTES}.
+ */
+export declare function validateAttachmentSize(file: File): string | null;
+//# sourceMappingURL=attachment-utils.d.ts.map

package/attachment/attachment-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-utils.d.ts","sourceRoot":"","sources":["../../src/attachment/attachment-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,QAAmB,CAAC;AAiDrD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAapD;AAID;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAapD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAKhE"}

package/attachment/attachment-utils.js

@@ -0,0 +1,104 @@
+/**
+ * Maximum attachment size in bytes (10 MB).
+ *
+ * Matches the CLI's `maxAttachmentSize` and the gRPC server's
+ * `MaxRecvMsgSize`. Files exceeding this limit are rejected before
+ * upload to avoid wasting bandwidth on requests that will fail.
+ */
+export const MAX_ATTACHMENT_BYTES = 10 * 1024 * 1024;
+/**
+ * Extension-to-MIME-type mapping for common file types.
+ *
+ * Used as a fallback when `File.type` is empty or generic. Mirrors
+ * the CLI's `detectContentType` to ensure consistent behavior.
+ */
+const EXTENSION_MIME_MAP = {
+    ".md": "text/markdown",
+    ".markdown": "text/markdown",
+    ".yaml": "application/x-yaml",
+    ".yml": "application/x-yaml",
+    ".json": "application/json",
+    ".csv": "text/csv",
+    ".tsv": "text/tab-separated-values",
+    ".xml": "application/xml",
+    ".html": "text/html",
+    ".htm": "text/html",
+    ".css": "text/css",
+    ".js": "application/javascript",
+    ".ts": "application/typescript",
+    ".py": "text/x-python",
+    ".go": "text/x-go",
+    ".rs": "text/x-rust",
+    ".java": "text/x-java",
+    ".rb": "text/x-ruby",
+    ".sh": "application/x-sh",
+    ".bash": "application/x-sh",
+    ".sql": "application/sql",
+    ".toml": "application/toml",
+    ".ini": "text/plain",
+    ".cfg": "text/plain",
+    ".conf": "text/plain",
+    ".env": "text/plain",
+    ".txt": "text/plain",
+    ".log": "text/plain",
+    ".pdf": "application/pdf",
+    ".zip": "application/zip",
+    ".gz": "application/gzip",
+    ".tar": "application/x-tar",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".webp": "image/webp",
+};
+/**
+ * Detects the MIME content type for a file.
+ *
+ * Prefers the browser-provided `File.type` when available and
+ * non-empty. Falls back to extension-based detection mirroring the
+ * CLI's `detectContentType` function. Returns
+ * `"application/octet-stream"` when neither source yields a result.
+ */
+export function detectContentType(file) {
+    if (file.type && file.type !== "application/octet-stream") {
+        return file.type;
+    }
+    const dotIndex = file.name.lastIndexOf(".");
+    if (dotIndex !== -1) {
+        const ext = file.name.slice(dotIndex).toLowerCase();
+        const mapped = EXTENSION_MIME_MAP[ext];
+        if (mapped)
+            return mapped;
+    }
+    return "application/octet-stream";
+}
+const SIZE_UNITS = ["B", "KB", "MB", "GB"];
+/**
+ * Formats a byte count as a human-readable string (e.g., `"2.3 MB"`).
+ *
+ * Uses base-1024 (binary) units with one decimal place, consistent
+ * with {@link formatArtifactSize} in the artifact utilities.
+ */
+export function formatFileSize(bytes) {
+    if (bytes === 0)
+        return "0 B";
+    const unitIndex = Math.min(Math.floor(Math.log(bytes) / Math.log(1024)), SIZE_UNITS.length - 1);
+    const value = bytes / Math.pow(1024, unitIndex);
+    return unitIndex === 0
+        ? `${bytes} B`
+        : `${value.toFixed(1)} ${SIZE_UNITS[unitIndex]}`;
+}
+/**
+ * Validates a file against the attachment size limit.
+ *
+ * Returns `null` when valid, or an error message string when the
+ * file exceeds {@link MAX_ATTACHMENT_BYTES}.
+ */
+export function validateAttachmentSize(file) {
+    if (file.size > MAX_ATTACHMENT_BYTES) {
+        return `${file.name} exceeds the 10 MB attachment limit (${formatFileSize(file.size)})`;
+    }
+    return null;
+}
+//# sourceMappingURL=attachment-utils.js.map

package/attachment/attachment-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-utils.js","sourceRoot":"","sources":["../../src/attachment/attachment-utils.ts"],"names":[],"mappings":"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"}

package/attachment/index.d.ts

@@ -0,0 +1,6 @@
+export { useAttachments } from "./useAttachments";
+export type { AttachmentPhase, AttachmentEntry, UseAttachmentsOptions, UseAttachmentsReturn, } from "./useAttachments";
+export { AttachmentChipList } from "./AttachmentChipList";
+export type { AttachmentChipListProps } from "./AttachmentChipList";
+export { MAX_ATTACHMENT_BYTES, detectContentType, formatFileSize, validateAttachmentSize, } from "./attachment-utils";
+//# sourceMappingURL=index.d.ts.map

package/attachment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/attachment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}

package/attachment/index.js

@@ -0,0 +1,4 @@
+export { useAttachments } from "./useAttachments";
+export { AttachmentChipList } from "./AttachmentChipList";
+export { MAX_ATTACHMENT_BYTES, detectContentType, formatFileSize, validateAttachmentSize, } from "./attachment-utils";
+//# sourceMappingURL=index.js.map

package/attachment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/attachment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAQlD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}

package/attachment/useAttachments.d.ts

@@ -0,0 +1,113 @@
+import type { AttachmentInput } from "@stigmer/sdk";
+/**
+ * Lifecycle phase of a single attachment managed by {@link useAttachments}.
+ *
+ * - `uploading` — bytes are being sent to the server
+ * - `ready` — upload succeeded, `storageKey` is available
+ * - `error` — upload failed, `error` describes the failure
+ */
+export type AttachmentPhase = "uploading" | "ready" | "error";
+/**
+ * State for a single file being managed by the hook.
+ *
+ * The `id` is a stable string generated at add-time, used as a React
+ * key and for removal. The same `File` added twice produces two
+ * independent entries with distinct IDs.
+ */
+export interface AttachmentEntry {
+    readonly id: string;
+    readonly file: File;
+    readonly phase: AttachmentPhase;
+    readonly contentType: string;
+    /** Set when `phase` is `"ready"`. */
+    readonly storageKey: string | null;
+    /** Set when `phase` is `"error"`. */
+    readonly error: string | null;
+}
+export interface UseAttachmentsOptions {
+    /**
+     * Called when a file is rejected during `addFiles` (e.g., exceeds
+     * the size limit). Consumers can use this for toast notifications.
+     */
+    readonly onValidationError?: (message: string) => void;
+}
+export interface UseAttachmentsReturn {
+    /** Current attachment entries (uploading, ready, or errored). */
+    readonly entries: readonly AttachmentEntry[];
+    /** True when at least one entry is in the `"uploading"` phase. */
+    readonly isUploading: boolean;
+    /** Number of entries that are ready for submission. */
+    readonly readyCount: number;
+    /** True when there are entries and all are ready (none uploading or errored). */
+    readonly allReady: boolean;
+    /** True when there is at least one entry (in any phase). */
+    readonly hasEntries: boolean;
+    /**
+     * Add one or more files. Each file is validated and uploaded
+     * immediately. Invalid files (e.g., too large) are rejected via
+     * `onValidationError` and not added.
+     */
+    readonly addFiles: (files: FileList | File[]) => void;
+    /** Remove an entry by its stable ID. Aborts in-flight uploads. */
+    readonly removeEntry: (id: string) => void;
+    /** Retry a failed upload. */
+    readonly retryEntry: (id: string) => void;
+    /** Clear all entries and abort any in-flight uploads. */
+    readonly clear: () => void;
+    /**
+     * Produces the `AttachmentInput[]` suitable for execution creation.
+     * Only includes entries in the `"ready"` phase.
+     */
+    readonly toAttachmentInputs: () => AttachmentInput[];
+}
+/**
+ * Behavior hook that manages file attachments for agent executions.
+ *
+ * Handles the full lifecycle: file validation, upload via
+ * `stigmer.agentExecution.uploadAttachment()`, progress tracking,
+ * error handling, and retry. Produces `AttachmentInput[]` ready
+ * for execution creation.
+ *
+ * Files are uploaded immediately on selection so the `storageKey`
+ * is available by the time the user submits their message.
+ *
+ * Platform builders who want custom attachment UI import this hook
+ * directly. The {@link SessionComposer} styled component uses it
+ * internally.
+ *
+ * @example
+ * ```tsx
+ * function CustomComposer() {
+ *   const attachments = useAttachments({
+ *     onValidationError: (msg) => toast.error(msg),
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       <input
+ *         type="file"
+ *         multiple
+ *         onChange={(e) => {
+ *           if (e.target.files) attachments.addFiles(e.target.files);
+ *         }}
+ *       />
+ *       {attachments.entries.map((entry) => (
+ *         <div key={entry.id}>
+ *           {entry.file.name} — {entry.phase}
+ *           {entry.phase === "error" && (
+ *             <button onClick={() => attachments.retryEntry(entry.id)}>
+ *               Retry
+ *             </button>
+ *           )}
+ *           <button onClick={() => attachments.removeEntry(entry.id)}>
+ *             Remove
+ *           </button>
+ *         </div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useAttachments(options?: UseAttachmentsOptions): UseAttachmentsReturn;
+//# sourceMappingURL=useAttachments.d.ts.map

package/attachment/useAttachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachments.d.ts","sourceRoot":"","sources":["../../src/attachment/useAttachments.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAapD;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxD;AAED,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC;IACtD,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,6BAA6B;IAC7B,QAAQ,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,eAAe,EAAE,CAAC;CACtD;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,cAAc,CAC5B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,oBAAoB,CAqJtB"}

package/attachment/useAttachments.js

@@ -0,0 +1,175 @@
+"use client";
+import { useCallback, useRef, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { UploadAttachmentRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+import { detectContentType, validateAttachmentSize, } from "./attachment-utils";
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+let nextId = 0;
+function generateId() {
+    return `attachment-${++nextId}-${Date.now()}`;
+}
+/**
+ * Behavior hook that manages file attachments for agent executions.
+ *
+ * Handles the full lifecycle: file validation, upload via
+ * `stigmer.agentExecution.uploadAttachment()`, progress tracking,
+ * error handling, and retry. Produces `AttachmentInput[]` ready
+ * for execution creation.
+ *
+ * Files are uploaded immediately on selection so the `storageKey`
+ * is available by the time the user submits their message.
+ *
+ * Platform builders who want custom attachment UI import this hook
+ * directly. The {@link SessionComposer} styled component uses it
+ * internally.
+ *
+ * @example
+ * ```tsx
+ * function CustomComposer() {
+ *   const attachments = useAttachments({
+ *     onValidationError: (msg) => toast.error(msg),
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       <input
+ *         type="file"
+ *         multiple
+ *         onChange={(e) => {
+ *           if (e.target.files) attachments.addFiles(e.target.files);
+ *         }}
+ *       />
+ *       {attachments.entries.map((entry) => (
+ *         <div key={entry.id}>
+ *           {entry.file.name} — {entry.phase}
+ *           {entry.phase === "error" && (
+ *             <button onClick={() => attachments.retryEntry(entry.id)}>
+ *               Retry
+ *             </button>
+ *           )}
+ *           <button onClick={() => attachments.removeEntry(entry.id)}>
+ *             Remove
+ *           </button>
+ *         </div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useAttachments(options) {
+    const stigmer = useStigmer();
+    const [entries, setEntries] = useState([]);
+    const abortControllers = useRef(new Map());
+    const uploadFile = useCallback(async (id, file, contentType) => {
+        const controller = new AbortController();
+        abortControllers.current.set(id, controller);
+        try {
+            const bytes = new Uint8Array(await file.arrayBuffer());
+            if (controller.signal.aborted)
+                return;
+            const response = await stigmer.agentExecution.uploadAttachment(create(UploadAttachmentRequestSchema, {
+                filename: file.name,
+                content: bytes,
+                contentType,
+            }));
+            if (controller.signal.aborted)
+                return;
+            setEntries((prev) => prev.map((e) => e.id === id
+                ? { ...e, phase: "ready", storageKey: response.storageKey, error: null }
+                : e));
+        }
+        catch (err) {
+            if (controller.signal.aborted)
+                return;
+            const message = toError(err).message;
+            setEntries((prev) => prev.map((e) => e.id === id
+                ? { ...e, phase: "error", error: message }
+                : e));
+        }
+        finally {
+            abortControllers.current.delete(id);
+        }
+    }, [stigmer]);
+    const addFiles = useCallback((files) => {
+        const fileArray = Array.from(files);
+        const validEntries = [];
+        for (const file of fileArray) {
+            const sizeError = validateAttachmentSize(file);
+            if (sizeError) {
+                options?.onValidationError?.(sizeError);
+                continue;
+            }
+            const id = generateId();
+            const contentType = detectContentType(file);
+            validEntries.push({
+                id,
+                file,
+                phase: "uploading",
+                contentType,
+                storageKey: null,
+                error: null,
+            });
+            uploadFile(id, file, contentType);
+        }
+        if (validEntries.length > 0) {
+            setEntries((prev) => [...prev, ...validEntries]);
+        }
+    }, [options, uploadFile]);
+    const removeEntry = useCallback((id) => {
+        const controller = abortControllers.current.get(id);
+        if (controller) {
+            controller.abort();
+            abortControllers.current.delete(id);
+        }
+        setEntries((prev) => prev.filter((e) => e.id !== id));
+    }, []);
+    const retryEntry = useCallback((id) => {
+        setEntries((prev) => {
+            const entry = prev.find((e) => e.id === id);
+            if (!entry || entry.phase !== "error")
+                return prev;
+            uploadFile(id, entry.file, entry.contentType);
+            return prev.map((e) => e.id === id
+                ? { ...e, phase: "uploading", error: null }
+                : e);
+        });
+    }, [uploadFile]);
+    const clear = useCallback(() => {
+        for (const controller of abortControllers.current.values()) {
+            controller.abort();
+        }
+        abortControllers.current.clear();
+        setEntries([]);
+    }, []);
+    const toAttachmentInputs = useCallback(() => {
+        return entries
+            .filter((e) => e.phase === "ready" && e.storageKey !== null)
+            .map((e) => ({
+            filename: e.file.name,
+            storageKey: e.storageKey,
+            contentType: e.contentType,
+        }));
+    }, [entries]);
+    const isUploading = entries.some((e) => e.phase === "uploading");
+    const readyCount = entries.filter((e) => e.phase === "ready").length;
+    const hasEntries = entries.length > 0;
+    const allReady = hasEntries && readyCount === entries.length;
+    return {
+        entries,
+        isUploading,
+        readyCount,
+        allReady,
+        hasEntries,
+        addFiles,
+        removeEntry,
+        retryEntry,
+        clear,
+        toAttachmentInputs,
+    };
+}
+//# sourceMappingURL=useAttachments.js.map

package/attachment/useAttachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachments.js","sourceRoot":"","sources":["../../src/attachment/useAttachments.ts"],"names":[],"mappings":"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"}

package/composer/ComposerToolbar.d.ts

@@ -0,0 +1,37 @@
+import { type ConfigureMenuItem } from "./ConfigureMenu";
+export interface ComposerToolbarProps {
+    readonly disabled: boolean;
+    readonly isSubmitting: boolean;
+    readonly canSend: boolean;
+    readonly onSend: () => void;
+    readonly showAttach: boolean;
+    readonly attachmentCount: number;
+    readonly onAttachClick: () => void;
+    readonly showWorkspace: boolean;
+    readonly workspaceCount: number;
+    /** Pre-built workspace editor content for the popover. */
+    readonly workspaceContent: React.ReactNode;
+    readonly configureItems: readonly ConfigureMenuItem[];
+    readonly configOpen: boolean;
+    readonly onConfigOpenChange: (open: boolean) => void;
+    readonly configActivePanel: string | null;
+    readonly onConfigActivePanelChange: (panel: string | null) => void;
+    /** Render the picker content for a given configure panel id. */
+    readonly renderConfigPanel: (itemId: string) => React.ReactNode;
+    readonly showModelSelector: boolean;
+    readonly modelId?: string;
+    readonly onModelChange: (id: string) => void;
+}
+/**
+ * Composer toolbar — Zone 3 of the SessionComposer.
+ *
+ * Renders a two-tier toolbar following the frequency-of-interaction principle:
+ *
+ * **Tier 1 (always visible):** Attach, Workspace
+ * **Tier 2 (behind Configure menu):** Agent, MCP, Skills, Secrets
+ * **Right edge:** Model Selector, Send
+ *
+ * Separators are placed between conceptual groups using Gestalt proximity.
+ */
+export declare function ComposerToolbar({ disabled, isSubmitting, canSend, onSend, showAttach, attachmentCount, onAttachClick, showWorkspace, workspaceCount, workspaceContent, configureItems, configOpen, onConfigOpenChange, configActivePanel, onConfigActivePanelChange, renderConfigPanel, showModelSelector, modelId, onModelChange, }: ComposerToolbarProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ComposerToolbar.d.ts.map

package/composer/ComposerToolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposerToolbar.d.ts","sourceRoot":"","sources":["../../src/composer/ComposerToolbar.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AASxE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAI5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;IAInC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,0DAA0D;IAC1D,QAAQ,CAAC,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC;IAI3C,QAAQ,CAAC,cAAc,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,yBAAyB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACnE,gEAAgE;IAChE,QAAQ,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IAIhE,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,MAAM,EACN,UAAU,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,OAAO,EACP,aAAa,GACd,EAAE,oBAAoB,2CAwFtB"}

package/composer/ComposerToolbar.js

@@ -0,0 +1,24 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "@stigmer/theme";
+import { ContextPopover } from "./ContextPopover";
+import { ConfigureMenu } from "./ConfigureMenu";
+import { ModelSelector } from "../models/ModelSelector";
+import { PaperclipIcon, WorkspaceIcon, ArrowUpIcon, SpinnerIcon, } from "./icons";
+/**
+ * Composer toolbar — Zone 3 of the SessionComposer.
+ *
+ * Renders a two-tier toolbar following the frequency-of-interaction principle:
+ *
+ * **Tier 1 (always visible):** Attach, Workspace
+ * **Tier 2 (behind Configure menu):** Agent, MCP, Skills, Secrets
+ * **Right edge:** Model Selector, Send
+ *
+ * Separators are placed between conceptual groups using Gestalt proximity.
+ */
+export function ComposerToolbar({ disabled, isSubmitting, canSend, onSend, showAttach, attachmentCount, onAttachClick, showWorkspace, workspaceCount, workspaceContent, configureItems, configOpen, onConfigOpenChange, configActivePanel, onConfigActivePanelChange, renderConfigPanel, showModelSelector, modelId, onModelChange, }) {
+    const hasTier1 = showAttach || showWorkspace;
+    const hasTier2 = configureItems.length > 0;
+    return (_jsxs("div", { className: "flex items-center justify-between gap-2 border-t border-border/50 px-3 py-2", children: [_jsxs("div", { className: "flex items-center gap-1.5", children: [showAttach && (_jsxs("button", { type: "button", disabled: disabled, onClick: onAttachClick, className: cn("inline-flex items-center gap-1 rounded-md px-2 py-1.5 text-xs transition-colors", "text-muted-foreground hover:text-foreground hover:bg-accent/50", "disabled:pointer-events-none disabled:opacity-50"), "aria-label": "Attach files", children: [_jsx(PaperclipIcon, {}), _jsx("span", { children: "Attach" }), attachmentCount > 0 && (_jsx("span", { className: "rounded-full bg-primary/15 px-1.5 text-[0.6rem] font-medium text-primary", children: attachmentCount }))] })), showWorkspace && (_jsx(ContextPopover, { icon: _jsx(WorkspaceIcon, {}), label: "Workspace", count: workspaceCount, disabled: disabled, children: workspaceContent })), hasTier1 && hasTier2 && (_jsx("div", { className: "mx-0.5 h-4 w-px bg-border/50", "aria-hidden": "true" })), _jsx(ConfigureMenu, { open: configOpen, onOpenChange: onConfigOpenChange, activePanel: configActivePanel, onActivePanelChange: onConfigActivePanelChange, items: configureItems, renderPanel: renderConfigPanel, disabled: disabled }), (hasTier1 || hasTier2) && showModelSelector && (_jsx("div", { className: "mx-0.5 h-4 w-px bg-border/50", "aria-hidden": "true" })), showModelSelector && (_jsx(ModelSelector, { value: modelId, onValueChange: onModelChange, disabled: disabled }))] }), _jsx("button", { type: "button", disabled: !canSend, onClick: onSend, className: "flex h-8 w-8 shrink-0 items-center justify-center rounded-lg bg-primary text-primary-foreground transition-colors hover:bg-primary/90 disabled:pointer-events-none disabled:opacity-40", "aria-label": "Send message", children: isSubmitting ? _jsx(SpinnerIcon, {}) : _jsx(ArrowUpIcon, {}) })] }));
+}
+//# sourceMappingURL=ComposerToolbar.js.map

package/composer/ComposerToolbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposerToolbar.js","sourceRoot":"","sources":["../../src/composer/ComposerToolbar.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAA0B,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,SAAS,CAAC;AAsCjB;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,MAAM,EACN,UAAU,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,OAAO,EACP,aAAa,GACQ;IACrB,MAAM,QAAQ,GAAG,UAAU,IAAI,aAAa,CAAC;IAC7C,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;IAE3C,OAAO,CACL,eAAK,SAAS,EAAC,6EAA6E,aAC1F,eAAK,SAAS,EAAC,2BAA2B,aAGvC,UAAU,IAAI,CACb,kBACE,IAAI,EAAC,QAAQ,EACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,EAAE,CACX,iFAAiF,EACjF,gEAAgE,EAChE,kDAAkD,CACnD,gBACU,cAAc,aAEzB,KAAC,aAAa,KAAG,EACjB,oCAAmB,EAClB,eAAe,GAAG,CAAC,IAAI,CACtB,eAAM,SAAS,EAAC,0EAA0E,YACvF,eAAe,GACX,CACR,IACM,CACV,EAEA,aAAa,IAAI,CAChB,KAAC,cAAc,IACb,IAAI,EAAE,KAAC,aAAa,KAAG,EACvB,KAAK,EAAC,WAAW,EACjB,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,QAAQ,YAEjB,gBAAgB,GACF,CAClB,EAIA,QAAQ,IAAI,QAAQ,IAAI,CACvB,cAAK,SAAS,EAAC,8BAA8B,iBAAa,MAAM,GAAG,CACpE,EAID,KAAC,aAAa,IACZ,IAAI,EAAE,UAAU,EAChB,YAAY,EAAE,kBAAkB,EAChC,WAAW,EAAE,iBAAiB,EAC9B,mBAAmB,EAAE,yBAAyB,EAC9C,KAAK,EAAE,cAAc,EACrB,WAAW,EAAE,iBAAiB,EAC9B,QAAQ,EAAE,QAAQ,GAClB,EAID,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,iBAAiB,IAAI,CAC9C,cAAK,SAAS,EAAC,8BAA8B,iBAAa,MAAM,GAAG,CACpE,EAEA,iBAAiB,IAAI,CACpB,KAAC,aAAa,IACZ,KAAK,EAAE,OAAO,EACd,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,QAAQ,GAClB,CACH,IACG,EAIN,iBACE,IAAI,EAAC,QAAQ,EACb,QAAQ,EAAE,CAAC,OAAO,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAC,wLAAwL,gBACvL,cAAc,YAExB,YAAY,CAAC,CAAC,CAAC,KAAC,WAAW,KAAG,CAAC,CAAC,CAAC,KAAC,WAAW,KAAG,GAC1C,IACL,CACP,CAAC;AACJ,CAAC"}