@agent-native/toolkit 0.0.0-beta-20260819143124

package/dist/collab-ui/RemoteSelectionRings.js

@@ -0,0 +1,130 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * RemoteSelectionRings — renders colored outline rings + name tags over
+ * elements selected by remote participants.
+ *
+ * Each participant's presence payload may contain a `selection` key with an
+ * opaque descriptor (e.g. a CSS selector). The `resolveRect` callback maps
+ * a descriptor to a DOMRect (or null when the element isn't found). Rings
+ * are rendered as absolutely-positioned outlines anchored to the container.
+ *
+ * Usage:
+ *   <div style={{ position: "relative" }}>
+ *     {content}
+ *     <RemoteSelectionRings
+ *       others={others}
+ *       resolveRect={(selector) => document.querySelector(selector)?.getBoundingClientRect() ?? null}
+ *       containerRef={containerRef}
+ *     />
+ *   </div>
+ */
+import { useState, useEffect, useRef, useLayoutEffect, memo, } from "react";
+const RingItem = memo(function RingItem({ ring }) {
+    return (_jsx("div", { "aria-label": `${ring.label} selection`, style: {
+            position: "absolute",
+            top: ring.rect.top,
+            left: ring.rect.left,
+            width: ring.rect.width,
+            height: ring.rect.height,
+            outline: `2px solid ${ring.color}`,
+            outlineOffset: 2,
+            borderRadius: 3,
+            pointerEvents: "none",
+            boxShadow: `0 0 0 1px ${ring.color}40`,
+            zIndex: 9998,
+        }, children: _jsxs("div", { style: {
+                position: "absolute",
+                top: -20,
+                left: 0,
+                display: "flex",
+                alignItems: "center",
+                gap: 4,
+                backgroundColor: ring.color,
+                color: "#fff",
+                fontSize: 10,
+                fontWeight: 600,
+                padding: "1px 5px",
+                borderRadius: 3,
+                whiteSpace: "nowrap",
+                maxWidth: 160,
+                overflow: "hidden",
+                textOverflow: "ellipsis",
+            }, children: [ring.avatarUrl ? (_jsx("img", { src: ring.avatarUrl, alt: "", style: {
+                        width: 12,
+                        height: 12,
+                        borderRadius: "50%",
+                        flexShrink: 0,
+                    } })) : null, ring.label] }) }));
+});
+export function RemoteSelectionRings({ others, selectionKey = "selection", resolveRect, containerRef, className, }) {
+    const overlayRef = useRef(null);
+    const [rings, setRings] = useState([]);
+    // Recompute rings whenever others change or on animation frame.
+    const recompute = () => {
+        const container = containerRef.current;
+        if (!container) {
+            setRings([]);
+            return;
+        }
+        const containerRect = container.getBoundingClientRect();
+        const next = [];
+        for (const other of others) {
+            const raw = other.presence[selectionKey];
+            const selector = typeof raw === "string" ? raw : raw ? raw.selector : undefined;
+            if (!selector || typeof selector !== "string")
+                continue;
+            const selectionLabel = raw && typeof raw === "object" ? raw.label : undefined;
+            const domRect = resolveRect(selector);
+            if (!domRect)
+                continue;
+            // Convert viewport-relative rect to container-relative.
+            const top = domRect.top - containerRect.top;
+            const left = domRect.left - containerRect.left;
+            if (left + domRect.width < 0 ||
+                top + domRect.height < 0 ||
+                left > containerRect.width ||
+                top > containerRect.height) {
+                continue; // Out of container bounds — skip.
+            }
+            const baseName = other.isAgent
+                ? "AI"
+                : other.user.name || other.user.email;
+            next.push({
+                clientId: other.clientId,
+                color: other.user.color || "#94a3b8",
+                label: selectionLabel ? `${baseName} — ${selectionLabel}` : baseName,
+                avatarUrl: other.user.avatarUrl,
+                isAgent: other.isAgent,
+                rect: { top, left, width: domRect.width, height: domRect.height },
+            });
+        }
+        setRings(next);
+    };
+    // Recompute on scroll/resize of the container to keep rings in sync.
+    useLayoutEffect(() => {
+        recompute();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [others, selectionKey]);
+    useEffect(() => {
+        const container = containerRef.current;
+        if (!container)
+            return;
+        const observer = new ResizeObserver(() => recompute());
+        observer.observe(container);
+        container.addEventListener("scroll", recompute, { passive: true });
+        window.addEventListener("scroll", recompute, { passive: true });
+        return () => {
+            observer.disconnect();
+            container.removeEventListener("scroll", recompute);
+            window.removeEventListener("scroll", recompute);
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [containerRef]);
+    return (_jsx("div", { ref: overlayRef, "aria-hidden": true, style: {
+            position: "absolute",
+            inset: 0,
+            pointerEvents: "none",
+            overflow: "hidden",
+        }, className: className, children: rings.map((ring) => (_jsx(RingItem, { ring: ring }, ring.clientId))) }));
+}
+//# sourceMappingURL=RemoteSelectionRings.js.map

package/dist/collab-ui/RemoteSelectionRings.js.map

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

package/dist/collab-ui/agent-identity.d.ts

@@ -0,0 +1,9 @@
+export declare const AGENT_CLIENT_ID = 2147483647;
+export interface AgentIdentity {
+    clientId: number;
+    name: string;
+    email: string;
+    color: string;
+}
+export declare const DEFAULT_AGENT_IDENTITY: AgentIdentity;
+//# sourceMappingURL=agent-identity.d.ts.map

package/dist/collab-ui/agent-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-identity.d.ts","sourceRoot":"","sources":["../../src/collab-ui/agent-identity.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,eAAe,aAAa,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,sBAAsB,EAAE,aAKpC,CAAC"}

package/dist/collab-ui/agent-identity.js

@@ -0,0 +1,9 @@
+// Reserve the maximum signed 32-bit id so the agent never wins client leader election.
+export const AGENT_CLIENT_ID = 2147483647;
+export const DEFAULT_AGENT_IDENTITY = {
+    clientId: AGENT_CLIENT_ID,
+    name: "AI Assistant",
+    email: "agent@system",
+    color: "#00B5FF",
+};
+//# sourceMappingURL=agent-identity.js.map

package/dist/collab-ui/agent-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-identity.js","sourceRoot":"","sources":["../../src/collab-ui/agent-identity.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;AAS1C,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,QAAQ,EAAE,eAAe;IACzB,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,cAAc;IACrB,KAAK,EAAE,SAAS;CACjB,CAAC"}

package/dist/collab-ui/index.d.ts

@@ -0,0 +1,9 @@
+export { AgentPresenceChip, type AgentPresenceChipProps, } from "./AgentPresenceChip.js";
+export { AGENT_CLIENT_ID, DEFAULT_AGENT_IDENTITY, type AgentIdentity, } from "./agent-identity.js";
+export { LiveCursorOverlay, type CursorMapFn, type LiveCursorOverlayProps, } from "./LiveCursorOverlay.js";
+export { PresenceBar, type PresenceBarProps } from "./PresenceBar.js";
+export { isReconcileLeadClient } from "./lead-client.js";
+export { RecentEditHighlights, type RecentEditHighlightsProps, } from "./RecentEditHighlights.js";
+export { RemoteSelectionRings, type RemoteSelectionRingsProps, type SelectionDescriptor, } from "./RemoteSelectionRings.js";
+export { RECENT_EDITS_MAX, RECENT_EDIT_TTL_MS, dedupeCollabUsersByEmail, emailToColor, emailToName, type AttributedRecentEdit, type CollabUser, type NormalizedPoint, type OtherPresence, type PresencePayload, type RecentEdit, type RecentEditDescriptor, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/collab-ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collab-ui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EACL,oBAAoB,EACpB,KAAK,yBAAyB,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,YAAY,EACZ,WAAW,EACX,KAAK,oBAAoB,EACzB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,oBAAoB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/collab-ui/index.js

@@ -0,0 +1,9 @@
+export { AgentPresenceChip, } from "./AgentPresenceChip.js";
+export { AGENT_CLIENT_ID, DEFAULT_AGENT_IDENTITY, } from "./agent-identity.js";
+export { LiveCursorOverlay, } from "./LiveCursorOverlay.js";
+export { PresenceBar } from "./PresenceBar.js";
+export { isReconcileLeadClient } from "./lead-client.js";
+export { RecentEditHighlights, } from "./RecentEditHighlights.js";
+export { RemoteSelectionRings, } from "./RemoteSelectionRings.js";
+export { RECENT_EDITS_MAX, RECENT_EDIT_TTL_MS, dedupeCollabUsersByEmail, emailToColor, emailToName, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/collab-ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/collab-ui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAElB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,eAAe,EACf,sBAAsB,GAEvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,GAGlB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EACL,oBAAoB,GAErB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oBAAoB,GAGrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,YAAY,EACZ,WAAW,GAQZ,MAAM,YAAY,CAAC"}

package/dist/collab-ui/lead-client.d.ts

@@ -0,0 +1,3 @@
+import type { Awareness } from "y-protocols/awareness";
+export declare function isReconcileLeadClient(awareness: Awareness | null | undefined, localClientId: number | null | undefined): boolean;
+//# sourceMappingURL=lead-client.d.ts.map

package/dist/collab-ui/lead-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lead-client.d.ts","sourceRoot":"","sources":["../../src/collab-ui/lead-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAMvD,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACvC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,OAAO,CAsBT"}

package/dist/collab-ui/lead-client.js

@@ -0,0 +1,29 @@
+import { AGENT_CLIENT_ID } from "./agent-identity.js";
+// Exactly one visible non-agent client may apply an external snapshot; allowing
+// every client to reconcile it duplicates concurrent CRDT inserts.
+export function isReconcileLeadClient(awareness, localClientId) {
+    if (localClientId == null)
+        return false;
+    if (!awareness)
+        return true;
+    let hasPeer = false;
+    let minVisible = localClientId;
+    awareness.getStates().forEach((state, clientId) => {
+        if (clientId === AGENT_CLIENT_ID || clientId === localClientId)
+            return;
+        const candidate = state;
+        if (!candidate?.user)
+            return;
+        hasPeer = true;
+        if (candidate.visible !== false && clientId < minVisible) {
+            minVisible = clientId;
+        }
+    });
+    if (!hasPeer)
+        return true;
+    const localHidden = typeof document !== "undefined" && document.visibilityState === "hidden";
+    if (localHidden)
+        return false;
+    return localClientId <= minVisible;
+}
+//# sourceMappingURL=lead-client.js.map

package/dist/collab-ui/lead-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lead-client.js","sourceRoot":"","sources":["../../src/collab-ui/lead-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,gFAAgF;AAChF,mEAAmE;AACnE,MAAM,UAAU,qBAAqB,CACnC,SAAuC,EACvC,aAAwC;IAExC,IAAI,aAAa,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,UAAU,GAAG,aAAa,CAAC;IAC/B,SAAS,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QAChD,IAAI,QAAQ,KAAK,eAAe,IAAI,QAAQ,KAAK,aAAa;YAAE,OAAO;QACvE,MAAM,SAAS,GAAG,KAA8C,CAAC;QACjE,IAAI,CAAC,SAAS,EAAE,IAAI;YAAE,OAAO;QAC7B,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,SAAS,CAAC,OAAO,KAAK,KAAK,IAAI,QAAQ,GAAG,UAAU,EAAE,CAAC;YACzD,UAAU,GAAG,QAAQ,CAAC;QACxB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,WAAW,GACf,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ,CAAC;IAC3E,IAAI,WAAW;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,aAAa,IAAI,UAAU,CAAC;AACrC,CAAC"}

package/dist/collab-ui/types.d.ts

@@ -0,0 +1,48 @@
+export interface CollabUser {
+    name: string;
+    email: string;
+    color: string;
+    avatarUrl?: string;
+}
+export type PresencePayload = Record<string, unknown>;
+export interface OtherPresence {
+    clientId: number;
+    user: CollabUser;
+    presence: PresencePayload;
+    isAgent: boolean;
+}
+export interface NormalizedPoint {
+    x: number;
+    y: number;
+}
+export type RecentEditDescriptor = {
+    kind: "text";
+    quote: string;
+} | {
+    kind: "selector";
+    selector: string;
+} | {
+    kind: "paths";
+    paths: string[];
+} | {
+    kind: "doc";
+} | {
+    kind: string;
+    [key: string]: unknown;
+};
+export interface RecentEdit {
+    descriptor: RecentEditDescriptor;
+    label?: string;
+    at: number;
+}
+export interface AttributedRecentEdit extends RecentEdit {
+    clientId: number;
+    user: OtherPresence["user"];
+    isAgent: boolean;
+}
+export declare const RECENT_EDITS_MAX = 5;
+export declare const RECENT_EDIT_TTL_MS = 10000;
+export declare function emailToColor(email: string): string;
+export declare function emailToName(email: string): string;
+export declare function dedupeCollabUsersByEmail(users: CollabUser[]): CollabUser[];
+//# sourceMappingURL=types.d.ts.map

package/dist/collab-ui/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/collab-ui/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,oBAAoB,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAezC,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAMD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAsB1E"}

package/dist/collab-ui/types.js

@@ -0,0 +1,52 @@
+export const RECENT_EDITS_MAX = 5;
+export const RECENT_EDIT_TTL_MS = 10_000;
+const CURSOR_COLORS = [
+    "#f87171",
+    "#fb923c",
+    "#fbbf24",
+    "#a3e635",
+    "#34d399",
+    "#22d3ee",
+    "#60a5fa",
+    "#14b8a6",
+    "#f472b6",
+    "#e879f9",
+];
+export function emailToColor(email) {
+    let hash = 0;
+    for (let i = 0; i < email.length; i++) {
+        hash = ((hash << 5) - hash + email.charCodeAt(i)) | 0;
+    }
+    return CURSOR_COLORS[Math.abs(hash) % CURSOR_COLORS.length];
+}
+export function emailToName(email) {
+    const local = email.split("@")[0] || email;
+    return local.charAt(0).toUpperCase() + local.slice(1);
+}
+function normalizeCollabEmail(email) {
+    return email.trim().toLowerCase();
+}
+export function dedupeCollabUsersByEmail(users) {
+    const byEmail = new Map();
+    for (const user of users) {
+        // Awareness is a network boundary. Older clients or partially-written
+        // states can contain a malformed user payload; ignore it instead of
+        // letting a missing email reach normalizeCollabEmail().
+        if (!user || typeof user.email !== "string")
+            continue;
+        const email = normalizeCollabEmail(user.email);
+        if (!email || byEmail.has(email))
+            continue;
+        byEmail.set(email, {
+            name: typeof user.name === "string" && user.name.trim()
+                ? user.name
+                : emailToName(email),
+            email,
+            color: typeof user.color === "string" && user.color.trim()
+                ? user.color
+                : emailToColor(email),
+        });
+    }
+    return Array.from(byEmail.values());
+}
+//# sourceMappingURL=types.js.map

package/dist/collab-ui/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/collab-ui/types.ts"],"names":[],"mappings":"AAwCA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAClC,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC,MAAM,aAAa,GAAG;IACpB,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;IAC3C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACzC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAmB;IAC1D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,sEAAsE;QACtE,oEAAoE;QACpE,wDAAwD;QACxD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;YAAE,SAAS;QACtD,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE;YACjB,IAAI,EACF,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBAC/C,CAAC,CAAC,IAAI,CAAC,IAAI;gBACX,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC;YACxB,KAAK;YACL,KAAK,EACH,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;gBACjD,CAAC,CAAC,IAAI,CAAC,KAAK;gBACZ,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/collab-ui/types.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.spec.d.ts.map

package/dist/collab-ui/types.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.spec.d.ts","sourceRoot":"","sources":["../../src/collab-ui/types.spec.ts"],"names":[],"mappings":""}

package/dist/collab-ui/types.spec.js

@@ -0,0 +1,15 @@
+import { describe, expect, it } from "vitest";
+import { dedupeCollabUsersByEmail } from "./types.js";
+describe("dedupeCollabUsersByEmail", () => {
+    it("ignores malformed awareness user payloads", () => {
+        expect(dedupeCollabUsersByEmail([
+            {
+                name: "Broken",
+                email: undefined,
+                color: "#fff",
+            },
+            { name: "Real", email: "real@example.com", color: "#000" },
+        ])).toEqual([{ name: "Real", email: "real@example.com", color: "#000" }]);
+    });
+});
+//# sourceMappingURL=types.spec.js.map

package/dist/collab-ui/types.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.spec.js","sourceRoot":"","sources":["../../src/collab-ui/types.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CACJ,wBAAwB,CAAC;YACvB;gBACE,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,SAA8B;gBACrC,KAAK,EAAE,MAAM;aACd;YACD,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE;SAC3D,CAAC,CACH,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/composer/AgentComposerFrame.d.ts

@@ -0,0 +1,19 @@
+import type React from "react";
+import type { AgentComposerLayoutVariant } from "./types.js";
+export interface AgentComposerFrameProps {
+    children: React.ReactNode;
+    className?: string;
+    rootClassName?: string;
+    style?: React.CSSProperties;
+    rootStyle?: React.CSSProperties;
+    layoutVariant?: AgentComposerLayoutVariant;
+    onClick?: React.MouseEventHandler<HTMLDivElement>;
+}
+/**
+ * The single visual shell for agent chat composition.
+ *
+ * AssistantChat, PromptComposer, and host surfaces such as Agent-Native Code
+ * all render this same frame so the composer does not drift across products.
+ */
+export declare function AgentComposerFrame({ children, className, rootClassName, style, rootStyle, layoutVariant, onClick, }: AgentComposerFrameProps): React.JSX.Element;
+//# sourceMappingURL=AgentComposerFrame.d.ts.map

package/dist/composer/AgentComposerFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentComposerFrame.d.ts","sourceRoot":"","sources":["../../src/composer/AgentComposerFrame.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,SAAS,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAChC,aAAa,CAAC,EAAE,0BAA0B,CAAC;IAC3C,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,SAAS,EACT,aAAa,EACb,KAAK,EACL,SAAS,EACT,aAAyB,EACzB,OAAO,GACR,EAAE,uBAAuB,qBA+BzB"}

package/dist/composer/AgentComposerFrame.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ComposerPrimitive } from "@assistant-ui/react";
+import { cn } from "../utils.js";
+/**
+ * The single visual shell for agent chat composition.
+ *
+ * AssistantChat, PromptComposer, and host surfaces such as Agent-Native Code
+ * all render this same frame so the composer does not drift across products.
+ */
+export function AgentComposerFrame({ children, className, rootClassName, style, rootStyle, layoutVariant = "default", onClick, }) {
+    return (_jsx("div", { "data-agent-composer-variant": layoutVariant, "data-agent-composer-slot": "area", className: cn("agent-composer-area shrink-0 py-2", 
+        // Compact composers are nested in padded popovers; the default sidebar
+        // frame is the only layout that needs its own horizontal inset.
+        layoutVariant === "compact" ? "px-0" : "px-3", layoutVariant !== "default" && `agent-composer-area--${layoutVariant}`, className), style: style, onClick: onClick, children: _jsx(ComposerPrimitive.Root, { "data-agent-composer-variant": layoutVariant, "data-agent-composer-slot": "root", className: cn("agent-composer-root flex flex-col rounded-lg border border-input bg-muted/45 transition-colors focus-within:border-ring", layoutVariant !== "default" &&
+                `agent-composer-root--${layoutVariant}`, rootClassName), style: rootStyle, children: children }) }));
+}
+//# sourceMappingURL=AgentComposerFrame.js.map

package/dist/composer/AgentComposerFrame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentComposerFrame.js","sourceRoot":"","sources":["../../src/composer/AgentComposerFrame.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAajC;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,EACjC,QAAQ,EACR,SAAS,EACT,aAAa,EACb,KAAK,EACL,SAAS,EACT,aAAa,GAAG,SAAS,EACzB,OAAO,GACiB;IACxB,OAAO,CACL,6CAC+B,aAAa,8BACjB,MAAM,EAC/B,SAAS,EAAE,EAAE,CACX,mCAAmC;QACnC,uEAAuE;QACvE,gEAAgE;QAChE,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAC7C,aAAa,KAAK,SAAS,IAAI,wBAAwB,aAAa,EAAE,EACtE,SAAS,CACV,EACD,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,YAEhB,KAAC,iBAAiB,CAAC,IAAI,mCACQ,aAAa,8BACjB,MAAM,EAC/B,SAAS,EAAE,EAAE,CACX,yHAAyH,EACzH,aAAa,KAAK,SAAS;gBACzB,wBAAwB,aAAa,EAAE,EACzC,aAAa,CACd,EACD,KAAK,EAAE,SAAS,YAEf,QAAQ,GACc,GACrB,CACP,CAAC;AACJ,CAAC"}

package/dist/composer/ComposerPlusMenu.d.ts

@@ -0,0 +1,30 @@
+import React from "react";
+import type { ComposerMode } from "./types.js";
+export interface ComposerTerminalModeControl {
+    enabled: boolean;
+    onChange: (enabled: boolean) => void;
+    onNewTerminal?: () => void;
+}
+interface ComposerPlusMenuProps {
+    onSelectMode?: (mode: ComposerMode) => void;
+    onAttachmentError?: (message: string) => void;
+    /**
+     * Show the "Create Extension" entry. Extensions are optional and hidden
+     * unless the host explicitly enables their agent tool surface.
+     */
+    extensionTools?: boolean;
+    /**
+     * "full" (default): full + menu with Upload File, Create Skill, Schedule Task,
+     * Automation, and MCP Server. Extension is included only when
+     * `extensionTools` is true. "upload-only": clicking + opens the file picker
+     * directly — no popover, no other modes. Use for prompt popovers where the
+     * only thing to attach is a file. "terminal": one new-terminal action plus
+     * the Terminal mode switch.
+     */
+    mode?: "full" | "upload-only" | "terminal";
+    terminalModeControl?: ComposerTerminalModeControl;
+}
+export declare function isExtensionComposerMenuEnabled(extensionTools?: boolean): boolean;
+export declare function ComposerPlusMenu({ onSelectMode, onAttachmentError, extensionTools, mode, terminalModeControl, }: ComposerPlusMenuProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=ComposerPlusMenu.d.ts.map

package/dist/composer/ComposerPlusMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposerPlusMenu.d.ts","sourceRoot":"","sources":["../../src/composer/ComposerPlusMenu.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAMN,MAAM,OAAO,CAAC;AAaf,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,UAAU,qBAAqB;IAC7B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IAC5C,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,UAAU,CAAC;IAC3C,mBAAmB,CAAC,EAAE,2BAA2B,CAAC;CACnD;AAQD,wBAAgB,8BAA8B,CAC5C,cAAc,CAAC,EAAE,OAAO,GACvB,OAAO,CAET;AAoOD,wBAAgB,gBAAgB,CAAC,EAC/B,YAAY,EACZ,iBAAiB,EACjB,cAAsB,EACtB,IAAa,EACb,mBAAmB,GACpB,EAAE,qBAAqB,qBAgBvB"}