@shadowob/sdk 0.4.0 → 0.4.1

package/dist/index.d.cts

@@ -0,0 +1,1085 @@
+import { Socket } from 'socket.io-client';
+export { CLIENT_EVENTS, ClientEvent, SERVER_EVENTS, ServerEvent } from '@shadowob/shared';
+
+/** Message returned by the Shadow REST API and Socket.IO broadcasts */
+interface ShadowMessage {
+    id: string;
+    content: string;
+    channelId: string;
+    authorId: string;
+    threadId?: string | null;
+    replyToId?: string | null;
+    isPinned?: boolean;
+    createdAt: string;
+    updatedAt: string;
+    author?: {
+        id: string;
+        username: string;
+        displayName?: string | null;
+        avatarUrl?: string | null;
+        isBot?: boolean;
+    };
+    attachments?: ShadowAttachment[];
+}
+interface ShadowAttachment {
+    id: string;
+    filename: string;
+    url: string;
+    contentType: string;
+    size: number;
+    width?: number | null;
+    height?: number | null;
+}
+interface ShadowChannel {
+    id: string;
+    name: string;
+    type: string;
+    serverId: string;
+    description?: string | null;
+    position?: number;
+}
+interface ShadowDmChannel {
+    id: string;
+    user1Id: string;
+    user2Id: string;
+    createdAt: string;
+}
+interface ShadowThread {
+    id: string;
+    name: string;
+    channelId: string;
+    parentMessageId: string;
+    createdAt: string;
+}
+interface ShadowMember {
+    userId: string;
+    serverId: string;
+    role: string;
+    user?: ShadowUser;
+}
+interface ShadowInviteCode {
+    id: string;
+    code: string;
+    createdBy: string;
+    usedBy?: string | null;
+    usedAt?: string | null;
+    isActive: boolean;
+    note?: string | null;
+    createdAt: string;
+}
+interface ShadowServer {
+    id: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    iconUrl: string | null;
+    bannerUrl: string | null;
+    homepageHtml: string | null;
+    isPublic: boolean;
+}
+interface ShadowUser {
+    id: string;
+    username: string;
+    displayName?: string;
+    avatarUrl?: string;
+    isBot?: boolean;
+    agentId?: string;
+}
+interface ShadowNotification {
+    id: string;
+    userId: string;
+    type: string;
+    title: string;
+    body: string;
+    referenceId?: string;
+    referenceType?: string;
+    isRead: boolean;
+    createdAt: string;
+}
+interface ShadowChannelPolicy {
+    listen: boolean;
+    reply: boolean;
+    mentionOnly: boolean;
+    config: Record<string, unknown>;
+}
+interface ShadowRemoteChannel {
+    id: string;
+    name: string;
+    type: string;
+    policy: ShadowChannelPolicy;
+}
+interface ShadowRemoteServer {
+    id: string;
+    name: string;
+    slug?: string;
+    iconUrl?: string | null;
+    defaultPolicy: ShadowChannelPolicy;
+    channels: ShadowRemoteChannel[];
+}
+interface ShadowRemoteConfig {
+    agentId: string;
+    botUserId: string;
+    servers: ShadowRemoteServer[];
+}
+interface TypingPayload {
+    channelId: string;
+    userId: string;
+    username: string;
+}
+interface PresenceChangePayload {
+    userId: string;
+    status: 'online' | 'idle' | 'dnd' | 'offline';
+}
+interface PresenceActivityPayload {
+    userId: string;
+    activity: string | null;
+    channelId: string;
+}
+interface MemberJoinPayload {
+    channelId: string;
+    userId: string;
+}
+interface MemberLeavePayload {
+    channelId: string;
+    userId: string;
+}
+interface ReactionPayload {
+    messageId: string;
+    userId: string;
+    emoji: string;
+}
+interface MessageDeletedPayload {
+    id: string;
+    channelId: string;
+}
+interface ChannelCreatedPayload {
+    id: string;
+    name: string;
+    type: string;
+    serverId: string;
+}
+interface ChannelMemberAddedPayload {
+    channelId: string;
+    userId: string;
+}
+interface ChannelMemberRemovedPayload {
+    channelId: string;
+    userId: string;
+}
+interface ServerJoinedPayload {
+    serverId: string;
+    serverName: string;
+}
+interface PolicyChangedPayload {
+    agentId: string;
+    serverId: string;
+    channelId?: string | null;
+}
+interface DmMessage {
+    id: string;
+    content: string;
+    senderId: string;
+    receiverId: string;
+    dmChannelId: string;
+    channelId: string;
+    authorId: string;
+    author?: {
+        id: string;
+        username: string;
+        displayName?: string;
+        avatarUrl?: string;
+        isBot?: boolean;
+    };
+    createdAt: string;
+}
+interface ShadowFriendship {
+    id: string;
+    userId: string;
+    friendId: string;
+    status: 'pending' | 'accepted' | 'rejected';
+    createdAt: string;
+    user?: ShadowUser;
+    friend?: ShadowUser;
+}
+interface ShadowOAuthApp {
+    id: string;
+    name: string;
+    clientId: string;
+    clientSecret?: string;
+    redirectUris: string[];
+    scopes: string[];
+    createdAt: string;
+}
+interface ShadowOAuthConsent {
+    id: string;
+    appId: string;
+    appName: string;
+    scopes: string[];
+    createdAt: string;
+}
+interface ShadowOAuthToken {
+    access_token: string;
+    token_type: string;
+    expires_in: number;
+    refresh_token?: string;
+    scope: string;
+}
+interface ShadowListing {
+    id: string;
+    agentId: string;
+    title: string;
+    description: string;
+    pricePerHour: number;
+    currency: string;
+    tags: string[];
+    isActive: boolean;
+    createdAt: string;
+    agent?: {
+        id: string;
+        name: string;
+        status: string;
+    };
+}
+interface ShadowContract {
+    id: string;
+    listingId: string;
+    tenantId: string;
+    ownerId: string;
+    status: string;
+    startedAt: string;
+    expiresAt: string;
+    totalCost: number;
+    createdAt: string;
+}
+interface ShadowShop {
+    id: string;
+    serverId: string;
+    name: string;
+    description?: string | null;
+    isEnabled: boolean;
+}
+interface ShadowCategory {
+    id: string;
+    shopId: string;
+    name: string;
+    description?: string | null;
+    position: number;
+}
+interface ShadowProduct {
+    id: string;
+    shopId: string;
+    categoryId?: string | null;
+    name: string;
+    description?: string | null;
+    price: number;
+    currency: string;
+    stock: number;
+    status: string;
+    images: string[];
+    createdAt: string;
+}
+interface ShadowCartItem {
+    id: string;
+    productId: string;
+    quantity: number;
+    product?: ShadowProduct;
+}
+interface ShadowOrder {
+    id: string;
+    shopId: string;
+    buyerId: string;
+    status: string;
+    totalAmount: number;
+    currency: string;
+    items: {
+        productId: string;
+        quantity: number;
+        price: number;
+    }[];
+    createdAt: string;
+}
+interface ShadowReview {
+    id: string;
+    orderId: string;
+    productId: string;
+    userId: string;
+    rating: number;
+    content: string;
+    reply?: string | null;
+    createdAt: string;
+}
+interface ShadowWallet {
+    id: string;
+    userId: string;
+    balance: number;
+    currency: string;
+}
+interface ShadowTransaction {
+    id: string;
+    walletId: string;
+    type: string;
+    amount: number;
+    description?: string | null;
+    createdAt: string;
+}
+interface ShadowTask {
+    key: string;
+    title: string;
+    description: string;
+    reward: number;
+    status: string;
+    claimedAt?: string | null;
+}
+interface ShadowApp {
+    id: string;
+    serverId: string;
+    name: string;
+    slug: string;
+    type: string;
+    url?: string | null;
+    status: string;
+    createdAt: string;
+}
+interface ShadowNotificationPreferences {
+    strategy: 'all' | 'mention_only' | 'none';
+    mutedServerIds: string[];
+    mutedChannelIds: string[];
+}
+/** Events the server pushes to the client */
+interface ServerEventMap {
+    'message:new': (message: ShadowMessage) => void;
+    'message:updated': (message: ShadowMessage) => void;
+    'message:deleted': (payload: MessageDeletedPayload) => void;
+    'member:typing': (payload: TypingPayload) => void;
+    'member:join': (payload: MemberJoinPayload) => void;
+    'member:leave': (payload: MemberLeavePayload) => void;
+    'presence:change': (payload: PresenceChangePayload) => void;
+    'presence:activity': (payload: PresenceActivityPayload) => void;
+    'reaction:add': (payload: ReactionPayload) => void;
+    'reaction:remove': (payload: ReactionPayload) => void;
+    'notification:new': (notification: ShadowNotification) => void;
+    'dm:message:new': (message: DmMessage) => void;
+    'channel:created': (payload: ChannelCreatedPayload) => void;
+    'channel:member-added': (payload: ChannelMemberAddedPayload) => void;
+    'channel:member-removed': (payload: ChannelMemberRemovedPayload) => void;
+    'server:joined': (payload: ServerJoinedPayload) => void;
+    'agent:policy-changed': (payload: PolicyChangedPayload) => void;
+    error: (payload: {
+        message: string;
+    }) => void;
+}
+/** Events the client sends to the server */
+interface ClientEventMap {
+    'channel:join': (data: {
+        channelId: string;
+    }, ack?: (res: {
+        ok: boolean;
+    }) => void) => void;
+    'channel:leave': (data: {
+        channelId: string;
+    }) => void;
+    'message:send': (data: {
+        channelId: string;
+        content: string;
+        threadId?: string;
+        replyToId?: string;
+    }) => void;
+    'message:typing': (data: {
+        channelId: string;
+    }) => void;
+    'presence:update': (data: {
+        status: 'online' | 'idle' | 'dnd' | 'offline';
+    }) => void;
+    'presence:activity': (data: {
+        channelId: string;
+        activity: string | null;
+    }) => void;
+}
+
+/**
+ * Shadow REST API client.
+ *
+ * Provides typed HTTP methods for interacting with the Shadow server API.
+ */
+declare class ShadowClient {
+    private token;
+    private baseUrl;
+    constructor(baseUrl: string, token: string);
+    private request;
+    private requestRaw;
+    register(data: {
+        email: string;
+        password: string;
+        username: string;
+        displayName?: string;
+        inviteCode: string;
+    }): Promise<{
+        token: string;
+        user: ShadowUser;
+    }>;
+    login(data: {
+        email: string;
+        password: string;
+    }): Promise<{
+        token: string;
+        user: ShadowUser;
+    }>;
+    refreshToken(): Promise<{
+        token: string;
+    }>;
+    getMe(): Promise<ShadowUser>;
+    updateProfile(data: {
+        displayName?: string;
+        avatarUrl?: string | null;
+    }): Promise<ShadowUser>;
+    disconnect(): Promise<{
+        success: boolean;
+    }>;
+    listAgents(): Promise<{
+        id: string;
+        name: string;
+        status: string;
+    }[]>;
+    createAgent(data: {
+        name: string;
+        displayName?: string;
+        avatarUrl?: string | null;
+    }): Promise<{
+        id: string;
+        token: string;
+        userId: string;
+    }>;
+    getAgent(agentId: string): Promise<{
+        id: string;
+        name: string;
+        status: string;
+        userId: string;
+    }>;
+    updateAgent(agentId: string, data: {
+        name?: string;
+        displayName?: string;
+        avatarUrl?: string | null;
+    }): Promise<{
+        id: string;
+        name: string;
+    }>;
+    deleteAgent(agentId: string): Promise<{
+        success: boolean;
+    }>;
+    generateAgentToken(agentId: string): Promise<{
+        token: string;
+    }>;
+    startAgent(agentId: string): Promise<{
+        ok: boolean;
+    }>;
+    stopAgent(agentId: string): Promise<{
+        ok: boolean;
+    }>;
+    sendHeartbeat(agentId: string): Promise<{
+        ok: boolean;
+    }>;
+    getAgentConfig(agentId: string): Promise<ShadowRemoteConfig>;
+    listPolicies(agentId: string, serverId: string): Promise<{
+        channelId: string | null;
+        mentionOnly: boolean;
+        reply: boolean;
+        config: Record<string, unknown>;
+    }[]>;
+    upsertPolicy(agentId: string, serverId: string, data: {
+        channelId?: string | null;
+        mentionOnly?: boolean;
+        reply?: boolean;
+        config?: Record<string, unknown>;
+    }): Promise<{
+        channelId: string | null;
+        mentionOnly: boolean;
+        reply: boolean;
+    }>;
+    deletePolicy(agentId: string, serverId: string, channelId: string): Promise<{
+        success: boolean;
+    }>;
+    discoverServers(): Promise<ShadowServer[]>;
+    getServerByInvite(inviteCode: string): Promise<ShadowServer>;
+    createServer(data: {
+        name: string;
+        slug?: string;
+        description?: string;
+        isPublic?: boolean;
+    }): Promise<ShadowServer>;
+    listServers(): Promise<ShadowServer[]>;
+    getServer(serverIdOrSlug: string): Promise<ShadowServer>;
+    updateServer(serverIdOrSlug: string, data: {
+        name?: string;
+        description?: string | null;
+        slug?: string | null;
+        homepageHtml?: string | null;
+        isPublic?: boolean;
+    }): Promise<ShadowServer>;
+    updateServerHomepage(serverIdOrSlug: string, homepageHtml: string | null): Promise<ShadowServer>;
+    deleteServer(serverId: string): Promise<{
+        success: boolean;
+    }>;
+    joinServer(serverId: string, inviteCode?: string): Promise<{
+        success: boolean;
+    }>;
+    leaveServer(serverId: string): Promise<{
+        success: boolean;
+    }>;
+    getMembers(serverId: string): Promise<ShadowMember[]>;
+    updateMember(serverId: string, userId: string, data: {
+        role?: string;
+    }): Promise<ShadowMember>;
+    kickMember(serverId: string, userId: string): Promise<{
+        success: boolean;
+    }>;
+    regenerateInviteCode(serverId: string): Promise<{
+        inviteCode: string;
+    }>;
+    addAgentsToServer(serverId: string, agentIds: string[]): Promise<{
+        added: string[];
+    }>;
+    getServerChannels(serverId: string): Promise<ShadowChannel[]>;
+    createChannel(serverId: string, data: {
+        name: string;
+        type?: string;
+        description?: string;
+    }): Promise<ShadowChannel>;
+    getChannel(channelId: string): Promise<ShadowChannel>;
+    getChannelMembers(channelId: string): Promise<ShadowMember[]>;
+    updateChannel(channelId: string, data: {
+        name?: string;
+        description?: string | null;
+    }): Promise<ShadowChannel>;
+    deleteChannel(channelId: string): Promise<{
+        success: boolean;
+    }>;
+    reorderChannels(serverId: string, channelIds: string[]): Promise<{
+        success: boolean;
+    }>;
+    addChannelMember(channelId: string, userId: string): Promise<{
+        success: boolean;
+    }>;
+    removeChannelMember(channelId: string, userId: string): Promise<{
+        success: boolean;
+    }>;
+    setBuddyPolicy(channelId: string, data: {
+        buddyUserId: string;
+        mentionOnly?: boolean;
+        reply?: boolean;
+    }): Promise<{
+        success: boolean;
+    }>;
+    getBuddyPolicy(channelId: string): Promise<{
+        buddyUserId: string | null;
+        mentionOnly: boolean;
+        reply: boolean;
+    } | null>;
+    sendMessage(channelId: string, content: string, opts?: {
+        threadId?: string;
+        replyToId?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<ShadowMessage>;
+    getMessages(channelId: string, limit?: number, cursor?: string): Promise<{
+        messages: ShadowMessage[];
+        hasMore: boolean;
+    }>;
+    getMessage(messageId: string): Promise<ShadowMessage>;
+    editMessage(messageId: string, content: string): Promise<ShadowMessage>;
+    deleteMessage(messageId: string): Promise<void>;
+    pinMessage(messageId: string, channelId?: string): Promise<{
+        success: boolean;
+    }>;
+    unpinMessage(messageId: string, channelId?: string): Promise<{
+        success: boolean;
+    }>;
+    getPinnedMessages(channelId: string): Promise<ShadowMessage[]>;
+    addReaction(messageId: string, emoji: string): Promise<void>;
+    removeReaction(messageId: string, emoji: string): Promise<void>;
+    getReactions(messageId: string): Promise<{
+        emoji: string;
+        count: number;
+        users: string[];
+    }[]>;
+    listThreads(channelId: string): Promise<ShadowThread[]>;
+    createThread(channelId: string, name: string, parentMessageId: string): Promise<{
+        id: string;
+        name: string;
+    }>;
+    getThread(threadId: string): Promise<ShadowThread>;
+    updateThread(threadId: string, data: {
+        name?: string;
+    }): Promise<ShadowThread>;
+    deleteThread(threadId: string): Promise<{
+        success: boolean;
+    }>;
+    getThreadMessages(threadId: string, limit?: number, cursor?: string): Promise<ShadowMessage[]>;
+    sendToThread(threadId: string, content: string): Promise<ShadowMessage>;
+    createDmChannel(userId: string): Promise<ShadowDmChannel>;
+    listDmChannels(): Promise<ShadowDmChannel[]>;
+    getDmMessages(channelId: string, limit?: number, cursor?: string): Promise<ShadowMessage[]>;
+    sendDmMessage(channelId: string, content: string, options?: {
+        replyToId?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<ShadowMessage>;
+    listNotifications(limit?: number, offset?: number): Promise<ShadowNotification[]>;
+    markNotificationRead(notificationId: string): Promise<{
+        success: boolean;
+    }>;
+    markAllNotificationsRead(): Promise<{
+        success: boolean;
+    }>;
+    getUnreadCount(): Promise<{
+        count: number;
+    }>;
+    searchMessages(query: {
+        q: string;
+        serverId?: string;
+        channelId?: string;
+        authorId?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        messages: ShadowMessage[];
+        total: number;
+    }>;
+    listInvites(): Promise<ShadowInviteCode[]>;
+    createInvites(count: number, note?: string): Promise<ShadowInviteCode[]>;
+    deactivateInvite(inviteId: string): Promise<ShadowInviteCode>;
+    deleteInvite(inviteId: string): Promise<{
+        success: boolean;
+    }>;
+    uploadMedia(file: Blob | ArrayBuffer, filename: string, contentType: string, messageId?: string): Promise<{
+        url: string;
+        key: string;
+        size: number;
+    }>;
+    /**
+     * Download a file from a URL and upload it to the Shadow media service.
+     * Supports local filesystem paths, file:// URLs, tilde paths, and HTTP(S) URLs.
+     */
+    uploadMediaFromUrl(mediaUrl: string, messageId?: string): Promise<{
+        url: string;
+        key: string;
+        size: number;
+    }>;
+    downloadFile(fileUrl: string): Promise<{
+        buffer: ArrayBuffer;
+        contentType: string;
+        filename: string;
+    }>;
+    getWorkspace(serverId: string): Promise<Record<string, unknown>>;
+    updateWorkspace(serverId: string, data: {
+        name?: string;
+        description?: string | null;
+    }): Promise<Record<string, unknown>>;
+    getWorkspaceTree(serverId: string): Promise<Record<string, unknown>>;
+    getWorkspaceStats(serverId: string): Promise<Record<string, unknown>>;
+    getWorkspaceChildren(serverId: string, parentId?: string | null): Promise<Record<string, unknown>[]>;
+    batchWorkspaceChildren(serverId: string, parentIds: (string | null)[]): Promise<Record<string, Record<string, unknown>[]>>;
+    createWorkspaceFolder(serverId: string, data: {
+        parentId?: string | null;
+        name: string;
+    }): Promise<Record<string, unknown>>;
+    updateWorkspaceFolder(serverId: string, folderId: string, data: {
+        name?: string;
+        parentId?: string | null;
+        pos?: number;
+    }): Promise<Record<string, unknown>>;
+    deleteWorkspaceFolder(serverId: string, folderId: string): Promise<{
+        success: boolean;
+    }>;
+    searchWorkspaceFolders(serverId: string, query: {
+        searchText?: string;
+        limit?: number;
+    }): Promise<Record<string, unknown>[]>;
+    createWorkspaceFile(serverId: string, data: {
+        parentId?: string | null;
+        name: string;
+        ext?: string | null;
+        mime?: string | null;
+        sizeBytes?: number | null;
+        contentRef?: string | null;
+        previewUrl?: string | null;
+        metadata?: Record<string, unknown> | null;
+    }): Promise<Record<string, unknown>>;
+    searchWorkspaceFiles(serverId: string, query: {
+        parentId?: string;
+        searchText?: string;
+        ext?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
+    getWorkspaceFile(serverId: string, fileId: string): Promise<Record<string, unknown>>;
+    updateWorkspaceFile(serverId: string, fileId: string, data: {
+        name?: string;
+        parentId?: string | null;
+        pos?: number;
+        ext?: string | null;
+        mime?: string | null;
+        sizeBytes?: number | null;
+        contentRef?: string | null;
+        previewUrl?: string | null;
+        metadata?: Record<string, unknown> | null;
+    }): Promise<Record<string, unknown>>;
+    deleteWorkspaceFile(serverId: string, fileId: string): Promise<{
+        success: boolean;
+    }>;
+    cloneWorkspaceFile(serverId: string, fileId: string): Promise<Record<string, unknown>>;
+    pasteWorkspaceNodes(serverId: string, data: {
+        sourceWorkspaceId: string;
+        targetParentId?: string | null;
+        nodeIds: string[];
+        mode: 'copy' | 'cut';
+    }): Promise<Record<string, unknown>>;
+    executeWorkspaceCommands(serverId: string, commands: Record<string, unknown>[]): Promise<Record<string, unknown>[]>;
+    uploadWorkspaceFile(serverId: string, file: Blob, filename: string, parentId?: string): Promise<Record<string, unknown>>;
+    downloadWorkspace(serverId: string): Promise<ArrayBuffer>;
+    downloadWorkspaceFolder(serverId: string, folderId: string): Promise<ArrayBuffer>;
+    getUserProfile(userId: string): Promise<ShadowUser>;
+    listOAuthAccounts(): Promise<{
+        id: string;
+        provider: string;
+        providerAccountId: string;
+    }[]>;
+    unlinkOAuthAccount(accountId: string): Promise<{
+        success: boolean;
+    }>;
+    sendFriendRequest(username: string): Promise<ShadowFriendship>;
+    acceptFriendRequest(requestId: string): Promise<ShadowFriendship>;
+    rejectFriendRequest(requestId: string): Promise<ShadowFriendship>;
+    removeFriend(friendshipId: string): Promise<{
+        success: boolean;
+    }>;
+    listFriends(): Promise<ShadowFriendship[]>;
+    listPendingFriendRequests(): Promise<ShadowFriendship[]>;
+    listSentFriendRequests(): Promise<ShadowFriendship[]>;
+    markScopeRead(scope: {
+        serverId?: string;
+        channelId?: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    getScopedUnread(): Promise<Record<string, number>>;
+    getNotificationPreferences(): Promise<ShadowNotificationPreferences>;
+    updateNotificationPreferences(data: Partial<ShadowNotificationPreferences>): Promise<ShadowNotificationPreferences>;
+    createOAuthApp(data: {
+        name: string;
+        redirectUris: string[];
+        scopes?: string[];
+    }): Promise<ShadowOAuthApp>;
+    listOAuthApps(): Promise<ShadowOAuthApp[]>;
+    updateOAuthApp(appId: string, data: {
+        name?: string;
+        redirectUris?: string[];
+        scopes?: string[];
+    }): Promise<ShadowOAuthApp>;
+    deleteOAuthApp(appId: string): Promise<{
+        success: boolean;
+    }>;
+    resetOAuthAppSecret(appId: string): Promise<{
+        clientSecret: string;
+    }>;
+    getOAuthAuthorization(params: {
+        client_id: string;
+        redirect_uri: string;
+        scope?: string;
+        state?: string;
+    }): Promise<{
+        app: ShadowOAuthApp;
+    }>;
+    approveOAuthAuthorization(data: {
+        client_id: string;
+        redirect_uri: string;
+        scope?: string;
+        state?: string;
+    }): Promise<{
+        redirectUrl: string;
+    }>;
+    exchangeOAuthToken(data: {
+        grant_type: 'authorization_code' | 'refresh_token';
+        code?: string;
+        refresh_token?: string;
+        client_id: string;
+        client_secret: string;
+        redirect_uri?: string;
+    }): Promise<ShadowOAuthToken>;
+    listOAuthConsents(): Promise<ShadowOAuthConsent[]>;
+    revokeOAuthConsent(appId: string): Promise<{
+        success: boolean;
+    }>;
+    browseListings(params?: {
+        search?: string;
+        tags?: string[];
+        minPrice?: number;
+        maxPrice?: number;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        listings: ShadowListing[];
+        total: number;
+    }>;
+    getListing(listingId: string): Promise<ShadowListing>;
+    estimateRentalCost(listingId: string, hours: number): Promise<{
+        totalCost: number;
+        currency: string;
+    }>;
+    listMyListings(): Promise<ShadowListing[]>;
+    createListing(data: {
+        agentId: string;
+        title: string;
+        description: string;
+        pricePerHour: number;
+        currency?: string;
+        tags?: string[];
+    }): Promise<ShadowListing>;
+    updateListing(listingId: string, data: Partial<{
+        title: string;
+        description: string;
+        pricePerHour: number;
+        tags: string[];
+    }>): Promise<ShadowListing>;
+    toggleListing(listingId: string): Promise<ShadowListing>;
+    deleteListing(listingId: string): Promise<{
+        success: boolean;
+    }>;
+    signContract(data: {
+        listingId: string;
+        hours: number;
+    }): Promise<ShadowContract>;
+    listContracts(params?: {
+        role?: 'tenant' | 'owner';
+        status?: string;
+    }): Promise<ShadowContract[]>;
+    getContract(contractId: string): Promise<ShadowContract>;
+    terminateContract(contractId: string): Promise<ShadowContract>;
+    recordUsageSession(contractId: string, data: {
+        durationMinutes: number;
+        description?: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    reportViolation(contractId: string, data: {
+        reason: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+    getShop(serverId: string): Promise<ShadowShop>;
+    updateShop(serverId: string, data: Partial<{
+        name: string;
+        description: string | null;
+        isEnabled: boolean;
+    }>): Promise<ShadowShop>;
+    listCategories(serverId: string): Promise<ShadowCategory[]>;
+    createCategory(serverId: string, data: {
+        name: string;
+        description?: string;
+    }): Promise<ShadowCategory>;
+    updateCategory(serverId: string, categoryId: string, data: Partial<{
+        name: string;
+        description: string | null;
+        position: number;
+    }>): Promise<ShadowCategory>;
+    deleteCategory(serverId: string, categoryId: string): Promise<{
+        success: boolean;
+    }>;
+    listProducts(serverId: string, params?: {
+        status?: string;
+        categoryId?: string;
+        keyword?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        products: ShadowProduct[];
+        total: number;
+    }>;
+    getProduct(serverId: string, productId: string): Promise<ShadowProduct>;
+    createProduct(serverId: string, data: {
+        name: string;
+        description?: string;
+        price: number;
+        currency?: string;
+        stock: number;
+        categoryId?: string;
+        images?: string[];
+    }): Promise<ShadowProduct>;
+    updateProduct(serverId: string, productId: string, data: Partial<{
+        name: string;
+        description: string | null;
+        price: number;
+        stock: number;
+        status: string;
+        categoryId: string | null;
+        images: string[];
+    }>): Promise<ShadowProduct>;
+    deleteProduct(serverId: string, productId: string): Promise<{
+        success: boolean;
+    }>;
+    getCart(serverId: string): Promise<ShadowCartItem[]>;
+    addToCart(serverId: string, data: {
+        productId: string;
+        quantity: number;
+    }): Promise<ShadowCartItem>;
+    updateCartItem(serverId: string, itemId: string, quantity: number): Promise<ShadowCartItem>;
+    removeCartItem(serverId: string, itemId: string): Promise<{
+        success: boolean;
+    }>;
+    createOrder(serverId: string, data?: {
+        items?: {
+            productId: string;
+            quantity: number;
+        }[];
+    }): Promise<ShadowOrder>;
+    listOrders(serverId: string): Promise<ShadowOrder[]>;
+    listShopOrders(serverId: string): Promise<ShadowOrder[]>;
+    getOrder(serverId: string, orderId: string): Promise<ShadowOrder>;
+    updateOrderStatus(serverId: string, orderId: string, status: string): Promise<ShadowOrder>;
+    cancelOrder(serverId: string, orderId: string): Promise<ShadowOrder>;
+    getProductReviews(serverId: string, productId: string): Promise<ShadowReview[]>;
+    createReview(serverId: string, orderId: string, data: {
+        productId: string;
+        rating: number;
+        content: string;
+    }): Promise<ShadowReview>;
+    replyToReview(serverId: string, reviewId: string, reply: string): Promise<ShadowReview>;
+    getWallet(): Promise<ShadowWallet>;
+    topUpWallet(amount: number): Promise<ShadowWallet>;
+    getWalletTransactions(): Promise<ShadowTransaction[]>;
+    getEntitlements(serverId: string): Promise<Record<string, unknown>[]>;
+    getTaskCenter(): Promise<{
+        tasks: ShadowTask[];
+    }>;
+    claimTask(taskKey: string): Promise<{
+        success: boolean;
+        reward: number;
+    }>;
+    getReferralSummary(): Promise<{
+        count: number;
+        rewards: number;
+    }>;
+    getRewardHistory(): Promise<{
+        rewards: {
+            amount: number;
+            reason: string;
+            createdAt: string;
+        }[];
+    }>;
+    listApps(serverId: string, params?: {
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        apps: ShadowApp[];
+        total: number;
+    }>;
+    getHomepageApp(serverId: string): Promise<ShadowApp | null>;
+    getApp(serverId: string, appId: string): Promise<ShadowApp>;
+    createApp(serverId: string, data: {
+        name: string;
+        slug: string;
+        type: string;
+        url?: string;
+    }): Promise<ShadowApp>;
+    updateApp(serverId: string, appId: string, data: Partial<{
+        name: string;
+        slug: string;
+        type: string;
+        url: string;
+        status: string;
+    }>): Promise<ShadowApp>;
+    deleteApp(serverId: string, appId: string): Promise<{
+        success: boolean;
+    }>;
+    publishApp(serverId: string, data: {
+        name: string;
+        slug: string;
+    }): Promise<ShadowApp>;
+}
+
+/** Build a Socket.IO room name for a channel */
+declare const channelRoom: (channelId: string) => `channel:${string}`;
+/** Build a Socket.IO room name for a thread */
+declare const threadRoom: (threadId: string) => `thread:${string}`;
+/** Build a Socket.IO room name for user-level notifications */
+declare const userRoom: (userId: string) => `user:${string}`;
+
+interface ShadowSocketOptions {
+    /** Shadow server base URL (e.g. "https://shadowob.shadowob.com") */
+    serverUrl: string;
+    /** JWT token for authentication */
+    token: string;
+    /** Socket.IO transports (default: ['websocket']) */
+    transports?: string[];
+    /** Auto-reconnect on disconnect (default: true) */
+    autoReconnect?: boolean;
+    /** Reconnection delay in ms (default: 1000) */
+    reconnectionDelay?: number;
+}
+type ServerEventName = keyof ServerEventMap;
+type ServerEventHandler<E extends ServerEventName> = ServerEventMap[E];
+/**
+ * Shadow real-time event listener.
+ *
+ * Wraps Socket.IO with strongly-typed events that match the Shadow server
+ * gateway broadcasts. Provides channel/thread room management and
+ * convenience methods for sending messages and typing indicators.
+ */
+declare class ShadowSocket {
+    private socket;
+    private _connected;
+    constructor(options: ShadowSocketOptions);
+    /** Whether the socket is currently connected */
+    get connected(): boolean;
+    /** The underlying Socket.IO socket instance */
+    get raw(): Socket;
+    /** Connect to the Shadow server */
+    connect(): void;
+    /** Disconnect from the Shadow server */
+    disconnect(): void;
+    /** Wait until the socket is connected (resolves immediately if already connected) */
+    waitForConnect(timeoutMs?: number): Promise<void>;
+    /** Listen for a server event */
+    on<E extends ServerEventName>(event: E, handler: ServerEventHandler<E>): this;
+    /** Listen for a server event (one-time) */
+    once<E extends ServerEventName>(event: E, handler: ServerEventHandler<E>): this;
+    /** Remove a specific event listener */
+    off<E extends ServerEventName>(event: E, handler: ServerEventHandler<E>): this;
+    /** Remove all listeners for an event or all events */
+    removeAllListeners(event?: ServerEventName): this;
+    /** Listen for raw connection events (connect, disconnect, connect_error) */
+    onConnect(handler: () => void): this;
+    onDisconnect(handler: (reason: string) => void): this;
+    onConnectError(handler: (error: Error) => void): this;
+    /** Join a channel room to receive its messages and events */
+    joinChannel(channelId: string): Promise<{
+        ok: boolean;
+    }>;
+    /** Leave a channel room */
+    leaveChannel(channelId: string): void;
+    /** Send a message via WebSocket (text-only; for file attachments use REST) */
+    sendMessage(data: {
+        channelId: string;
+        content: string;
+        threadId?: string;
+        replyToId?: string;
+    }): void;
+    /** Send a typing indicator */
+    sendTyping(channelId: string): void;
+    /** Update user presence status */
+    updatePresence(status: 'online' | 'idle' | 'dnd' | 'offline'): void;
+    /** Update activity status in a channel (e.g. 'thinking', 'working', null) */
+    updateActivity(channelId: string, activity: string | null): void;
+    /** Join a DM channel room */
+    joinDmChannel(dmChannelId: string): void;
+    /** Leave a DM channel room */
+    leaveDmChannel(dmChannelId: string): void;
+    /** Send a DM message via WebSocket */
+    sendDmMessage(data: {
+        dmChannelId: string;
+        content: string;
+        replyToId?: string;
+    }): void;
+    /** Send a DM typing indicator */
+    sendDmTyping(dmChannelId: string): void;
+}
+
+export { type ChannelCreatedPayload, type ChannelMemberAddedPayload, type ChannelMemberRemovedPayload, type ClientEventMap, type DmMessage, type MemberJoinPayload, type MemberLeavePayload, type MessageDeletedPayload, type PolicyChangedPayload, type PresenceActivityPayload, type PresenceChangePayload, type ReactionPayload, type ServerEventMap, type ServerJoinedPayload, type ShadowApp, type ShadowAttachment, type ShadowCartItem, type ShadowCategory, type ShadowChannel, type ShadowChannelPolicy, ShadowClient, type ShadowContract, type ShadowDmChannel, type ShadowFriendship, type ShadowInviteCode, type ShadowListing, type ShadowMember, type ShadowMessage, type ShadowNotification, type ShadowNotificationPreferences, type ShadowOAuthApp, type ShadowOAuthConsent, type ShadowOAuthToken, type ShadowOrder, type ShadowProduct, type ShadowRemoteChannel, type ShadowRemoteConfig, type ShadowRemoteServer, type ShadowReview, type ShadowServer, type ShadowShop, ShadowSocket, type ShadowSocketOptions, type ShadowTask, type ShadowThread, type ShadowTransaction, type ShadowUser, type ShadowWallet, type TypingPayload, channelRoom, threadRoom, userRoom };