@workspace-platform/ui 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,784 @@
+import React from 'react';
+import { Socket } from 'socket.io-client';
+import { UseBoundStore, StoreApi } from 'zustand';
+import { ClassValue } from 'clsx';
+
+interface WorkspaceClient {
+    get: <T>(path: string) => Promise<T>;
+    post: <T>(path: string, body: unknown) => Promise<T>;
+    patch: <T>(path: string, body: unknown) => Promise<T>;
+    delete: <T>(path: string) => Promise<T>;
+    upload: <T>(path: string, formData: FormData) => Promise<T>;
+    getBlob: (path: string) => Promise<Blob>;
+}
+declare function createWorkspaceClient(config: WorkspaceConfig): WorkspaceClient;
+
+interface WorkspaceSocketManager {
+    getSocket: () => Socket;
+    connect: (userId?: string) => Socket;
+    disconnect: () => void;
+}
+declare function createWorkspaceSocket(config: WorkspaceConfig): WorkspaceSocketManager;
+
+interface UserSearchResult {
+    id: string;
+    email: string;
+    displayName: string;
+    avatarUrl?: string;
+}
+interface WorkspaceConfig {
+    /** Base URL of the workspace-platform server (e.g. http://localhost:3100) */
+    baseUrl: string;
+    /** Function that returns the current Bearer token (JWT) */
+    getAuthToken: () => string | null;
+    /** Current user identifier (email or ID) — used for socket auth & UI */
+    currentUserId: string | null;
+    /** Current user display name */
+    currentUserName?: string | null;
+    /** Optional: additional headers for API requests (e.g. { 'x-auth-mode': 'keycloak' }) */
+    extraHeaders?: Record<string, string>;
+    /** Optional: function to search users for member invitation */
+    searchUsers?: (query: string) => Promise<UserSearchResult[]>;
+    /** Optional: function to resolve user avatar URLs by email */
+    resolveAvatars?: (memberIds: string[]) => Promise<Record<string, string>>;
+    /** Optional: callback when navigating to a workspace */
+    onNavigateToWorkspace?: (workspaceId: string) => void;
+}
+interface WorkspaceContextValue {
+    config: WorkspaceConfig;
+    apiClient: WorkspaceClient;
+    socket: WorkspaceSocketManager;
+}
+declare function WorkspaceProvider({ config, children, }: {
+    config: WorkspaceConfig;
+    children: React.ReactNode;
+}): React.JSX.Element;
+declare function useWorkspaceContext(): WorkspaceContextValue;
+
+type WorkspaceStatus = 'ACTIVE' | 'CLOSED' | 'ARCHIVED';
+type ArtefactType = 'NOTE' | 'EXPORT' | 'DECISION' | 'FILE' | 'TASK';
+type MemberType = 'user' | 'agent';
+type MemberRole = 'owner' | 'participant' | 'viewer';
+declare enum WorkspaceEvent {
+    WORKSPACE_CREATED = "workspace.created",
+    WORKSPACE_UPDATED = "workspace.updated",
+    WORKSPACE_DELETED = "workspace.deleted",
+    WORKSPACE_STATUS_CHANGED = "workspace.statusChanged",
+    /** Sent to user's personal room when they are added as a member */
+    WORKSPACE_ADDED = "workspace.added",
+    /** Sent to user's personal room when they are removed as a member */
+    WORKSPACE_REMOVED = "workspace.removed",
+    WORKSPACE_MEMBER_ADDED = "workspace.member.added",
+    WORKSPACE_MEMBER_UPDATED = "workspace.member.updated",
+    WORKSPACE_MEMBER_REMOVED = "workspace.member.removed",
+    WORKSPACE_MESSAGE_CREATED = "workspace.message.created",
+    WORKSPACE_MESSAGE_UPDATED = "workspace.message.updated",
+    WORKSPACE_MESSAGE_DELETED = "workspace.message.deleted",
+    WORKSPACE_MEMBER_USER_MENTIONED = "workspace.member.user.mentioned",
+    WORKSPACE_MEMBER_AGENT_MENTIONED = "workspace.member.agent.mentioned",
+    WORKSPACE_ARTEFACT_CREATED = "workspace.artefact.created",
+    WORKSPACE_TYPING_STARTED = "workspace.typing.started",
+    WORKSPACE_TYPING_STOPPED = "workspace.typing.stopped",
+    WORKSPACE_MESSAGE_REACTION_CREATED = "workspace.message.reaction.created",
+    WORKSPACE_MESSAGE_REACTION_DELETED = "workspace.message.reaction.deleted",
+    WORKSPACE_MESSAGE_PINNED = "workspace.message.pinned",
+    PRIVATE_WORKSPACE_CREATED = "private.workspace.created",
+    PRIVATE_WORKSPACE_MESSAGE_CREATED = "private.workspace.message.created",
+    PRIVATE_WORKSPACE_MEMBER_ADDED = "private.workspace.member.added"
+}
+interface PaginatedResponse<T> {
+    data: T[];
+    total: number;
+    offset: number;
+    limit: number;
+}
+interface EntityWithSecret {
+    key: string;
+    value: string;
+    isSecret: boolean;
+}
+interface WorkspaceType {
+    _id: string;
+    name: string;
+    entitiesWithSecrets?: EntityWithSecret[];
+    createdBy?: string;
+    updatedBy?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface Workspace {
+    _id: string;
+    name: string;
+    isPrivate?: boolean;
+    type?: WorkspaceType | string;
+    scope?: string;
+    entitiesWithSecrets?: EntityWithSecret[];
+    status: WorkspaceStatus;
+    syncWithSlack?: boolean;
+    createdBy?: string;
+    updatedBy?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface WorkspaceMember {
+    _id: string;
+    workspace: string;
+    memberId: string;
+    memberName: string;
+    memberType: MemberType;
+    role: MemberRole;
+    createdBy?: string;
+    updatedBy?: string;
+    joinedAt: string;
+    createdAt?: string;
+}
+/** Subset of WorkspaceMessage returned when populated as a reply reference */
+interface ReplyMessage {
+    _id: string;
+    senderId: string;
+    senderName: string;
+    senderType: MemberType;
+    content: string;
+    createdAt: string;
+    /** Set locally when the replied-to message is soft-deleted */
+    deleted?: boolean;
+}
+interface WorkspaceMessage {
+    _id: string;
+    workspace: string;
+    senderId: string;
+    senderName: string;
+    senderType: MemberType;
+    sender?: WorkspaceMessageSender;
+    content: string;
+    mentionedUsers?: string[];
+    mentionedAgents?: string[];
+    replyToMessage?: ReplyMessage | null;
+    metadata?: Record<string, unknown>;
+    deleted?: boolean;
+    editedAt?: string;
+    pinned?: boolean;
+    pinnedAt?: string;
+    pinnedBy?: string;
+    createdBy?: string;
+    createdAt: string;
+}
+interface WorkspaceMessageSender {
+    _id: string;
+    memberId: string;
+    memberName: string;
+    memberType: MemberType;
+    role: MemberRole;
+}
+interface FileRecord {
+    _id: string;
+    filename: string;
+    originalName: string;
+    mimetype: string;
+    size: number;
+    bucket: string;
+    key: string;
+    storageProvider: string;
+    createdBy?: string;
+    updatedBy?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface WorkspaceArtefact {
+    _id: string;
+    workspace: string;
+    message?: string;
+    file: FileRecord;
+    type: ArtefactType;
+    createdBy?: string;
+    updatedBy?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface WorkspaceMessageReaction {
+    _id: string;
+    reaction: string;
+    message: string;
+    member?: string;
+    memberId?: string;
+    memberName?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface MessageWithArtefacts extends WorkspaceMessage {
+    artefacts: WorkspaceArtefact[];
+    reactions: WorkspaceMessageReaction[];
+}
+interface WorkspaceAgent {
+    _id: string;
+    agentId: string;
+    agentName: string;
+    webhookCount: number;
+    createdBy?: string;
+    updatedBy?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface AgentDeleteInfo {
+    webhookCount: number;
+    memberCount: number;
+}
+interface WebhookSubscription {
+    _id: string;
+    name: string;
+    targetUrl: string;
+    secretKey: string;
+    secretValue: string;
+    eventTypes: string[];
+    active: boolean;
+    isAgent: boolean;
+    agentId?: string;
+    metadata?: Record<string, unknown>;
+    createdBy?: string;
+    updatedBy?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface WorkspaceSummary {
+    _id: string;
+    workspace: string;
+    keyPoints: string[];
+    keyTasks: string[];
+    keyDecisions: string[];
+    messageCount: number;
+    lastMessage?: {
+        _id: string;
+        senderId: string;
+        senderName: string;
+        senderType: MemberType;
+        content: string;
+        createdAt: string;
+    } | null;
+    wasTruncated: boolean;
+    generatedAt: string;
+    threadId?: string;
+    threadState?: 'queued' | 'running' | 'succeeded' | 'failed';
+    createdBy?: string;
+    updatedBy?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface LatestSummaryResponse {
+    summary: WorkspaceSummary | null;
+    messagesAfterCount: number;
+}
+interface CreateWorkspacePayload {
+    name: string;
+    isPrivate?: boolean;
+    type?: string;
+    scope?: string;
+    entitiesWithSecrets?: EntityWithSecret[];
+    members?: {
+        memberId: string;
+        memberName: string;
+        memberType?: MemberType;
+        role?: string;
+    }[];
+    syncWithSlack?: boolean;
+}
+interface SendMessagePayload {
+    senderType?: MemberType;
+    content: string;
+    metadata?: Record<string, unknown>;
+    replyToMessageId?: string;
+}
+interface UpdateMessagePayload {
+    content: string;
+}
+/** workspace.created → emitted to each member's personal room */
+interface WsPayloadWorkspaceCreated {
+    workspace: Workspace;
+}
+/** workspace.added → emitted to the new member's personal room */
+interface WsPayloadWorkspaceAdded {
+    workspaceId: string;
+    workspace?: Workspace;
+}
+/** workspace.removed → emitted to the removed member's personal room */
+interface WsPayloadWorkspaceRemoved {
+    workspaceId: string;
+}
+/** workspace.updated → emitted to workspace room */
+interface WsPayloadWorkspaceUpdated {
+    workspace: Workspace;
+}
+/** workspace.statusChanged → emitted to workspace room */
+interface WsPayloadWorkspaceStatusChanged {
+    workspace: Workspace;
+}
+/** workspace.member.added → emitted to workspace room */
+interface WsPayloadMemberAdded {
+    workspaceId: string;
+    member: WorkspaceMember;
+}
+/** workspace.member.updated → emitted to workspace room */
+interface WsPayloadMemberUpdated {
+    workspaceId: string;
+    member: WorkspaceMember;
+}
+/**
+ * workspace.member.removed → emitted to workspace room.
+ * `memberId`       = the WorkspaceMember document _id (ObjectId string)
+ * `memberId_field` = the actual userId/email of the removed member
+ */
+interface WsPayloadMemberRemoved {
+    workspaceId: string;
+    memberId: string;
+    memberId_field: string;
+}
+/** workspace.message.created → emitted to workspace room */
+interface WsPayloadMessageCreated {
+    workspaceId: string;
+    message: WorkspaceMessage;
+}
+/** workspace.artefact.created → emitted to workspace room */
+interface WsPayloadArtefactCreated {
+    workspaceId: string;
+    artefacts: WorkspaceArtefact[];
+}
+/** workspace.typing.started / workspace.typing.stopped */
+interface WsPayloadTyping {
+    workspaceId: string;
+    member: {
+        memberId: string;
+        memberName: string;
+        memberType?: 'user' | 'agent' | string;
+    };
+}
+/** workspace.message.updated → emitted to workspace room */
+interface WsPayloadMessageUpdated {
+    workspaceId: string;
+    message: WorkspaceMessage;
+}
+/** workspace.message.deleted → emitted to workspace room */
+interface WsPayloadMessageDeleted {
+    workspaceId: string;
+    messageId: string;
+}
+/** workspace.message.reaction.created → emitted to workspace room */
+interface WsPayloadReactionCreated {
+    workspaceId: string;
+    messageId: string;
+    reaction: WorkspaceMessageReaction;
+}
+/** workspace.message.reaction.deleted → emitted to workspace room */
+interface WsPayloadReactionDeleted {
+    workspaceId: string;
+    messageId: string;
+    reaction: string;
+    memberId: string;
+    memberName: string;
+}
+/** workspace.message.pinned → emitted to workspace room */
+interface WsPayloadMessagePinned {
+    workspaceId: string;
+    message: WorkspaceMessage;
+    action: 'pinned' | 'unpinned';
+    author: string;
+}
+
+interface SyncLink {
+    provider: string;
+    externalId: string;
+    externalName?: string;
+    externalTeamId?: string;
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface SyncStatus {
+    syncWithSlack: boolean;
+    syncProviders?: string[];
+    links: SyncLink[];
+}
+interface SyncProviderInfo {
+    id: string;
+    enabled: boolean;
+}
+interface ToggleReactionResponse {
+    action: 'created' | 'deleted';
+    reaction: WorkspaceMessageReaction | null;
+}
+declare function createWorkspaceApis(client: WorkspaceClient): {
+    workspaceTypeApi: {
+        list: () => Promise<WorkspaceType[]>;
+        get: (id: string) => Promise<WorkspaceType>;
+        create: (payload: {
+            name: string;
+            entitiesWithSecrets?: EntityWithSecret[];
+        }) => Promise<WorkspaceType>;
+        update: (id: string, payload: {
+            name?: string;
+            entitiesWithSecrets?: EntityWithSecret[];
+        }) => Promise<WorkspaceType>;
+        delete: (id: string) => Promise<void>;
+    };
+    workspaceApi: {
+        list: (params?: {
+            search?: string;
+            status?: string;
+            type?: string;
+            isPrivate?: boolean;
+            limit?: number;
+            skip?: number;
+        }) => Promise<PaginatedResponse<Workspace>>;
+        get: (id: string) => Promise<Workspace>;
+        create: (payload: CreateWorkspacePayload) => Promise<Workspace>;
+        update: (id: string, payload: Partial<Omit<CreateWorkspacePayload, "members">>) => Promise<Workspace>;
+        updateStatus: (id: string, status: WorkspaceStatus) => Promise<Workspace>;
+        delete: (id: string) => Promise<void>;
+        startTyping: (id: string) => Promise<void>;
+        stopTyping: (id: string) => Promise<void>;
+        timeline: (workspaceId: string, params?: {
+            limit?: number;
+            offset?: number;
+            entityType?: string;
+        }) => Promise<PaginatedResponse<any>>;
+    };
+    memberApi: {
+        list: (workspaceId: string) => Promise<WorkspaceMember[]>;
+        add: (workspaceId: string, payload: {
+            memberId: string;
+            memberName: string;
+            memberType?: MemberType;
+            role?: MemberRole;
+        }) => Promise<WorkspaceMember>;
+        updateRole: (workspaceId: string, memberId: string, role: MemberRole) => Promise<WorkspaceMember>;
+        remove: (workspaceId: string, memberId: string) => Promise<void>;
+    };
+    messageApi: {
+        list: (workspaceId: string, params?: {
+            limit?: number;
+            offset?: number;
+            sort?: "asc" | "desc";
+        }) => Promise<PaginatedResponse<WorkspaceMessage>>;
+        send: (workspaceId: string, payload: SendMessagePayload) => Promise<WorkspaceMessage>;
+        update: (workspaceId: string, messageId: string, payload: UpdateMessagePayload) => Promise<WorkspaceMessage>;
+        delete: (workspaceId: string, messageId: string) => Promise<WorkspaceMessage>;
+        togglePin: (workspaceId: string, messageId: string) => Promise<WorkspaceMessage>;
+    };
+    artefactApi: {
+        upload: (workspaceId: string, files: File[], messageId?: string, artefactType?: string) => Promise<{
+            success: boolean;
+            count: number;
+            results: WorkspaceArtefact[];
+        }>;
+        list: (workspaceId: string, artefactType?: ArtefactType) => Promise<{
+            data: WorkspaceArtefact[];
+            total: number;
+        }>;
+        listPaginated: (workspaceId: string, params?: {
+            type?: ArtefactType;
+            limit?: number;
+            offset?: number;
+        }) => Promise<PaginatedResponse<WorkspaceArtefact>>;
+        delete: (workspaceId: string, artefactId: string) => Promise<unknown>;
+        getSignedUrl: (fileId: string) => Promise<{
+            url: string;
+        }>;
+        getDownloadBlob: (fileId: string) => Promise<Blob>;
+        messagesWithArtefacts: (workspaceId: string, params?: {
+            limit?: number;
+            offset?: number;
+            sort?: "asc" | "desc";
+            members?: string[];
+            concernsMe?: boolean;
+            pinned?: boolean;
+        }) => Promise<PaginatedResponse<MessageWithArtefacts>>;
+    };
+    reactionApi: {
+        toggle: (workspaceId: string, messageId: string, reaction: string) => Promise<ToggleReactionResponse>;
+    };
+    agentApi: {
+        list: (search?: string) => Promise<WorkspaceAgent[]>;
+        create: (body: {
+            agentId: string;
+            agentName: string;
+        }) => Promise<WorkspaceAgent>;
+        update: (id: string, body: {
+            agentName: string;
+        }) => Promise<WorkspaceAgent>;
+        delete: (id: string) => Promise<void>;
+        getDeleteInfo: (id: string) => Promise<AgentDeleteInfo>;
+    };
+    summaryApi: {
+        generate: (workspaceId: string) => Promise<WorkspaceSummary>;
+        getLatest: (workspaceId: string) => Promise<LatestSummaryResponse>;
+        getHistory: (workspaceId: string) => Promise<WorkspaceSummary[]>;
+        create: (workspaceId: string, payload: {
+            keyPoints: string[];
+            keyTasks: string[];
+            keyDecisions: string[];
+            messageCount: number;
+            lastMessage?: string;
+            wasTruncated?: boolean;
+            generatedAt?: string;
+        }) => Promise<WorkspaceSummary>;
+        update: (workspaceId: string, summaryId: string, payload: Partial<{
+            keyPoints: string[];
+            keyTasks: string[];
+            keyDecisions: string[];
+            messageCount: number;
+            wasTruncated: boolean;
+        }>) => Promise<WorkspaceSummary>;
+    };
+    webhookApi: {
+        list: (params?: {
+            search?: string;
+            isAgent?: string;
+            agentId?: string;
+        }) => Promise<WebhookSubscription[]>;
+        create: (data: {
+            name: string;
+            targetUrl: string;
+            secretKey: string;
+            secretValue: string;
+            eventTypes?: string[];
+            active?: boolean;
+            isAgent?: boolean;
+            agentId?: string;
+            metadata?: Record<string, unknown>;
+        }) => Promise<WebhookSubscription>;
+        update: (id: string, data: Partial<{
+            name: string;
+            targetUrl: string;
+            secretKey: string;
+            secretValue: string;
+            eventTypes: string[];
+            active: boolean;
+            isAgent: boolean;
+            agentId: string;
+            metadata: Record<string, unknown>;
+        }>) => Promise<WebhookSubscription>;
+        delete: (id: string) => Promise<unknown>;
+    };
+    syncApi: {
+        getAvailableProviders: () => Promise<SyncProviderInfo[]>;
+        getStatus: (workspaceId: string) => Promise<SyncStatus>;
+        toggleSync: (workspaceId: string, provider: string, enabled: boolean) => Promise<Workspace>;
+    };
+};
+type WorkspaceApis = ReturnType<typeof createWorkspaceApis>;
+
+/** Payload shape sent by the backend Atlas Change Stream trigger */
+interface ChangeLogData {
+    /** Full document snapshot (insert / replace events) */
+    fullDocument?: Record<string, unknown>;
+    /** Flat fields sent directly on data (legacy / simplified events) */
+    updatedFields?: Record<string, unknown>;
+    name?: string;
+    memberName?: string;
+    role?: string;
+    originalName?: string;
+    filename?: string;
+    /** MongoDB update description (update events) */
+    updateDescription?: {
+        updatedFields?: Record<string, unknown>;
+        removedFields?: string[];
+    };
+}
+/** Matches the backend ChangeLog schema */
+interface ChangeLog {
+    _id: string;
+    event: string;
+    timestamp: number;
+    type: string;
+    entityId: string;
+    data?: ChangeLogData;
+    createdBy?: string;
+    updatedBy?: string;
+}
+type ActivityIcon = 'created' | 'updated' | 'deleted' | 'member_added' | 'member_removed' | 'member_role' | 'artefact_added' | 'artefact_deleted' | 'archived' | 'generic';
+type EntityCategory = 'context' | 'members' | 'artefacts' | 'other';
+interface ActivityEntry {
+    _id: string;
+    title: string;
+    description: string;
+    date: string;
+    author: string;
+    icon: ActivityIcon;
+    category: EntityCategory;
+}
+interface FilterPill {
+    label: string;
+    value: string | undefined;
+    entityType: string | undefined;
+    category: EntityCategory | undefined;
+}
+declare const FILTER_PILLS: FilterPill[];
+declare const WORKSPACE_FIELD_LABELS: Record<string, string>;
+declare const WORKSPACE_STATUS_LABELS: Record<string, string>;
+declare const MEMBER_ROLE_LABELS: Record<string, string>;
+declare const IGNORED_FIELDS: string[];
+declare const CATEGORY_STYLES: Record<EntityCategory, {
+    dot: string;
+    badge: string;
+    label: string;
+}>;
+declare const ICON_COLOR: Record<ActivityIcon, string>;
+
+type WorkspaceTab = 'group' | 'private';
+interface WorkspaceListFilters {
+    search: string;
+    status: string;
+    type: string;
+}
+interface WorkspaceListState {
+    workspaces: Workspace[];
+    total: number;
+    membersMap: Record<string, WorkspaceMember[]>;
+    types: WorkspaceType[];
+    tab: WorkspaceTab;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+    filters: WorkspaceListFilters;
+    initialLoading: boolean;
+    fetching: boolean;
+    hydrated: boolean;
+    setTab: (tab: WorkspaceTab) => void;
+    setFilters: (filters: WorkspaceListFilters) => void;
+    setPage: (page: number) => void;
+    fetchWorkspaces: () => Promise<void>;
+    fetchTypes: () => Promise<void>;
+    prependWorkspace: (ws: Workspace, members?: WorkspaceMember[]) => void;
+    removeWorkspace: (workspaceId: string) => void;
+    refresh: () => Promise<void>;
+}
+/**
+ * Factory that creates a Zustand store bound to the injected API client.
+ * Call this inside your WorkspaceProvider or in a hook.
+ */
+declare function createWorkspaceListStore(apis: WorkspaceApis): UseBoundStore<StoreApi<WorkspaceListState>>;
+
+/**
+ * Hook to access all workspace API modules within a WorkspaceProvider.
+ * The APIs are memoized and only recreated when the client changes.
+ */
+declare function useWorkspaceApi(): WorkspaceApis;
+
+declare const AVAILABLE_AGENTS: {
+    memberId: string;
+    memberName: string;
+    memberType: MemberType;
+}[];
+declare const ROLE_LABELS: Record<string, string>;
+declare const STATUS_LABELS: Record<string, string>;
+declare function getInitials(name: string): string;
+
+interface WorkspaceExportData {
+    workspace: Workspace;
+    members: WorkspaceMember[];
+    messages: MessageWithArtefacts[];
+}
+/**
+ * Generates a formatted Markdown string representing the full workspace export.
+ * Includes context, members, and the complete discussion thread.
+ */
+declare function formatWorkspaceExport(data: WorkspaceExportData): string;
+
+/** Preset width for the centered panel */
+type ModalSize = 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | '6xl' | '7xl' | 'full';
+type ModalHeaderVariant = 'strip' | 'plain';
+interface ModalProps {
+    open: boolean;
+    onClose: () => void;
+    children: React.ReactNode;
+    zIndexClass?: string;
+    backdropClassName?: string;
+    size?: ModalSize;
+    panelClassName?: string;
+    className?: string;
+    closeOnBackdropClick?: boolean;
+    closeOnEscape?: boolean;
+    ariaLabelledBy?: string;
+    ariaDescribedBy?: string;
+    title?: React.ReactNode;
+    description?: React.ReactNode;
+    titleIcon?: React.ReactNode;
+    headingId?: string;
+    modalHeaderVariant?: ModalHeaderVariant;
+    hideCloseButton?: boolean;
+    headerTrailing?: React.ReactNode;
+    closeButtonAriaLabel?: string;
+    closeButtonDisabled?: boolean;
+    closeButtonClassName?: string;
+    closeIconSize?: number;
+    headerClassName?: string;
+    titleClassName?: string;
+    descriptionClassName?: string;
+}
+declare function Modal({ open, onClose, children, zIndexClass, backdropClassName, size, panelClassName, className, closeOnBackdropClick, closeOnEscape, ariaLabelledBy: ariaLabelledByProp, ariaDescribedBy: ariaDescribedByProp, title, description, titleIcon, headingId, modalHeaderVariant, hideCloseButton, headerTrailing, closeButtonAriaLabel, closeButtonDisabled, closeButtonClassName, closeIconSize, headerClassName, titleClassName, descriptionClassName, }: ModalProps): React.ReactPortal | null;
+
+declare function cn(...inputs: ClassValue[]): string;
+
+type AvatarSize = 'xs' | 'sm' | 'md' | 'lg';
+interface MemberAvatarProps {
+    memberName: string;
+    memberType: 'user' | 'agent';
+    avatarUrl?: string | null;
+    size?: AvatarSize;
+    className?: string;
+    variant?: 'primary' | 'owner' | 'currentUser';
+}
+declare const MemberAvatar: React.FC<MemberAvatarProps>;
+
+interface AvatarUser {
+    email: string;
+    avatarUrl?: string;
+}
+interface MembersPanelProps {
+    members: WorkspaceMember[];
+    avatarUsers?: AvatarUser[];
+    onAddMember?: (payload: {
+        memberId: string;
+        memberName: string;
+        memberType: MemberType;
+        role?: MemberRole;
+    }) => void;
+    onRemoveMember?: (memberId: string) => void;
+    onUpdateRole?: (memberId: string, role: MemberRole) => void;
+    readonly?: boolean;
+}
+declare const MembersPanel: React.FC<MembersPanelProps>;
+
+interface CreateWorkspaceModalProps {
+    open: boolean;
+    onClose: () => void;
+    onCreated?: (workspace: unknown) => void;
+}
+declare const CreateWorkspaceModal: React.FC<CreateWorkspaceModalProps>;
+
+interface CreatePrivateWorkspaceModalProps {
+    open: boolean;
+    onClose: () => void;
+    onCreated?: (workspace: unknown) => void;
+}
+declare const CreatePrivateWorkspaceModal: React.FC<CreatePrivateWorkspaceModalProps>;
+
+interface SyncPanelProps {
+    workspaceId: string;
+    syncWithSlack?: boolean;
+    isOwner: boolean;
+    /** Whether Slack sync is configured and enabled on the server */
+    slackConfigured?: boolean;
+    /** Called after a sync toggle — the parent page will get the updated workspace via real-time. */
+    onToggleSync?: (provider: string, enabled: boolean) => Promise<void>;
+}
+declare const SyncPanel: React.FC<SyncPanelProps>;
+
+interface PaginationProps {
+    currentPage: number;
+    totalPages: number;
+    onPageChange: (page: number) => void;
+    /** Show a subtle loading indicator when fetching */
+    loading?: boolean;
+}
+declare const Pagination: React.FC<PaginationProps>;
+
+export { AVAILABLE_AGENTS, type ActivityEntry, type ActivityIcon, type AgentDeleteInfo, type ArtefactType, type AvatarUser, CATEGORY_STYLES, type ChangeLog, type ChangeLogData, CreatePrivateWorkspaceModal, CreateWorkspaceModal, type CreateWorkspacePayload, type EntityCategory, type EntityWithSecret, FILTER_PILLS, type FileRecord, type FilterPill, ICON_COLOR, IGNORED_FIELDS, type LatestSummaryResponse, MEMBER_ROLE_LABELS, MemberAvatar, type MemberAvatarProps, type MemberRole, type MemberType, MembersPanel, type MessageWithArtefacts, Modal, type ModalProps, type ModalSize, type PaginatedResponse, Pagination, ROLE_LABELS, type ReplyMessage, STATUS_LABELS, type SendMessagePayload, type SyncLink, SyncPanel, type SyncProviderInfo, type SyncStatus, type ToggleReactionResponse, type UpdateMessagePayload, type UserSearchResult, WORKSPACE_FIELD_LABELS, WORKSPACE_STATUS_LABELS, type WebhookSubscription, type Workspace, type WorkspaceAgent, type WorkspaceApis, type WorkspaceArtefact, type WorkspaceClient, type WorkspaceConfig, type WorkspaceContextValue, WorkspaceEvent, type WorkspaceExportData, type WorkspaceListFilters, type WorkspaceListState, type WorkspaceMember, type WorkspaceMessage, type WorkspaceMessageReaction, type WorkspaceMessageSender, WorkspaceProvider, type WorkspaceSocketManager, type WorkspaceStatus, type WorkspaceSummary, type WorkspaceTab, type WorkspaceType, type WsPayloadArtefactCreated, type WsPayloadMemberAdded, type WsPayloadMemberRemoved, type WsPayloadMemberUpdated, type WsPayloadMessageCreated, type WsPayloadMessageDeleted, type WsPayloadMessagePinned, type WsPayloadMessageUpdated, type WsPayloadReactionCreated, type WsPayloadReactionDeleted, type WsPayloadTyping, type WsPayloadWorkspaceAdded, type WsPayloadWorkspaceCreated, type WsPayloadWorkspaceRemoved, type WsPayloadWorkspaceStatusChanged, type WsPayloadWorkspaceUpdated, cn, createWorkspaceApis, createWorkspaceClient, createWorkspaceListStore, createWorkspaceSocket, formatWorkspaceExport, getInitials, useWorkspaceApi, useWorkspaceContext };