@shadowob/sdk 1.1.3 → 1.1.5

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { MessageMention, MentionSuggestionTrigger, MentionSuggestion } from '@shadowob/shared';
+import { MessageMention, OAuthLinkCard, MentionSuggestionTrigger, MentionSuggestion } from '@shadowob/shared';
 export { CLIENT_EVENTS, ClientEvent, SERVER_EVENTS, ServerEvent } from '@shadowob/shared';
 import { Socket } from 'socket.io-client';
+import { IRemoteAudioTrack, IRemoteVideoTrack } from 'agora-rtc-sdk-ng';
 
 /** Message returned by the Shadow REST API and Socket.IO broadcasts */
 interface ShadowMessage {
@@ -94,6 +95,7 @@ interface ShadowMessageMetadata {
     interactiveResponse?: ShadowInteractiveResponse;
     interactiveState?: ShadowInteractiveState;
     commerceCards?: Array<ShadowCommerceProductCard | ShadowCommerceOfferCardInput>;
+    oauthLinkCards?: ShadowOAuthLinkCard[];
     [key: string]: unknown;
 }
 interface ShadowCommerceOfferCardInput {
@@ -102,6 +104,7 @@ interface ShadowCommerceOfferCardInput {
     offerId: string;
 }
 type ShadowMessageMention = MessageMention;
+type ShadowOAuthLinkCard = OAuthLinkCard;
 type ShadowMentionSuggestion = MentionSuggestion;
 type ShadowMentionSuggestionTrigger = MentionSuggestionTrigger;
 interface ShadowAttachment {
@@ -118,6 +121,149 @@ interface ShadowSignedMediaUrl {
     url: string;
     expiresAt: string;
 }
+type ShadowMediaVariant = 'avatar' | 'preview' | 'banner';
+type ShadowServerAppAction = 'read' | 'write' | 'manage' | 'delete' | 'generate';
+type ShadowServerAppDataClass = 'public' | 'server-private' | 'channel-private' | 'financial' | 'secret' | 'cloud-secret';
+interface ShadowServerAppCommand {
+    name: string;
+    title?: string;
+    description?: string;
+    path: string;
+    method?: 'POST';
+    input?: 'json' | 'multipart';
+    inputSchema?: Record<string, unknown>;
+    permission: string;
+    action: ShadowServerAppAction;
+    dataClass: ShadowServerAppDataClass;
+    approvalMode?: 'none' | 'first_time' | 'every_time' | 'policy';
+    binary?: {
+        supported?: boolean;
+        field?: string;
+        maxBytes?: number;
+        contentTypes?: string[];
+    };
+}
+interface ShadowServerAppManifest {
+    schemaVersion: 'shadow.app/1';
+    appKey: string;
+    name: string;
+    description?: string;
+    version?: string;
+    iconUrl: string;
+    iframe?: {
+        entry: string;
+        allowedOrigins: string[];
+    };
+    api: {
+        baseUrl: string;
+        auth?: {
+            type: 'oauth2-bearer';
+        };
+    };
+    commands: ShadowServerAppCommand[];
+    skills?: Array<{
+        name: string;
+        description: string;
+        commandHints?: string[];
+    }>;
+    events?: string[];
+    binary?: {
+        supported: boolean;
+        maxBytes?: number;
+        contentTypes?: string[];
+    };
+}
+interface ShadowServerAppIntegration {
+    id: string;
+    serverId: string;
+    appKey: string;
+    name: string;
+    description?: string | null;
+    iconUrl?: string | null;
+    manifestUrl?: string | null;
+    manifest: ShadowServerAppManifest;
+    iframeEntry?: string | null;
+    allowedOrigins: string[];
+    apiBaseUrl: string;
+    status: string;
+    installedByUserId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ShadowServerAppDiscovery {
+    manifest: ShadowServerAppManifest;
+    installed: ShadowServerAppIntegration | null;
+    permissions: Array<{
+        name: string;
+        title: string;
+        description?: string | null;
+        permission: string;
+        action: ShadowServerAppAction;
+        dataClass: ShadowServerAppDataClass;
+        approvalMode: 'none' | 'first_time' | 'every_time' | 'policy';
+    }>;
+}
+interface ShadowServerAppCatalogEntry {
+    id: string;
+    appKey: string;
+    name: string;
+    description?: string | null;
+    iconUrl?: string | null;
+    manifestUrl?: string | null;
+    manifest: ShadowServerAppManifest;
+    status: string;
+    installed?: ShadowServerAppIntegration | null;
+    permissions?: ShadowServerAppDiscovery['permissions'];
+    createdAt: string;
+    updatedAt: string;
+}
+interface ShadowServerAppLaunchContext {
+    serverId: string;
+    serverAppId: string;
+    appKey: string;
+    iframeEntry: string | null;
+    allowedOrigins: string[];
+    launchToken: string;
+    eventStreamPath: string;
+    expiresIn: number;
+}
+interface ShadowServerAppSkillDocument {
+    appKey: string;
+    markdown: string;
+    skills: Array<{
+        name: string;
+        description: string;
+        commandHints?: string[];
+    }>;
+}
+interface ShadowServerAppTokenIntrospection {
+    active: boolean;
+    token_type?: 'Bearer';
+    iss?: string;
+    aud?: string;
+    sub?: string;
+    scope?: string;
+    client_id?: string;
+    exp?: number;
+    iat?: number;
+    shadow?: {
+        protocol: 'shadow.app/1';
+        serverId: string;
+        serverAppId: string;
+        appKey: string;
+        command?: string;
+        actor: {
+            kind?: string;
+            userId?: string | null;
+            buddyAgentId?: string | null;
+            ownerId?: string | null;
+        };
+        channelId?: string | null;
+        permission?: string;
+        action?: string;
+        dataClass?: string;
+    };
+}
 interface ShadowChannel {
     id: string;
     name: string;
@@ -146,6 +292,65 @@ interface ShadowChannelJoinRequestResult {
     status: ShadowChannelJoinRequestStatus;
     requestId?: string;
 }
+interface ShadowVoiceParticipant {
+    id: string;
+    channelId: string;
+    userId: string;
+    uid: number;
+    screenUid: number;
+    username: string;
+    displayName: string | null;
+    avatarUrl: string | null;
+    isBot: boolean;
+    isMuted: boolean;
+    isDeafened: boolean;
+    isSpeaking: boolean;
+    isScreenSharing: boolean;
+    joinedAt: string;
+    updatedAt: string;
+    clientId: string | null;
+}
+interface ShadowVoiceCredentials {
+    appId: string;
+    channelId: string;
+    agoraChannelName: string;
+    uid: number;
+    screenUid: number;
+    token: string | null;
+    screenToken: string | null;
+    expiresAt: string | null;
+}
+interface ShadowVoiceState {
+    channelId: string;
+    agoraChannelName: string;
+    participants: ShadowVoiceParticipant[];
+    participantCount: number;
+    emptySince: string | null;
+    graceEndsAt: string | null;
+}
+interface ShadowVoiceJoinResult {
+    credentials: ShadowVoiceCredentials;
+    participant: ShadowVoiceParticipant;
+    state: ShadowVoiceState;
+}
+interface ShadowVoiceLeaveResult {
+    participant: ShadowVoiceParticipant | null;
+    state: ShadowVoiceState;
+    left?: boolean;
+}
+interface ShadowVoiceRenewResult {
+    credentials: ShadowVoiceCredentials;
+    state: ShadowVoiceState;
+}
+interface ShadowVoicePolicy {
+    agentId: string;
+    channelId: string;
+    listen: boolean;
+    autoJoin: boolean;
+    consumeAudio: boolean;
+    consumeScreenShare: boolean;
+    screenshotIntervalSeconds: number | null;
+}
 type ShadowServerJoinRequestStatus = 'pending' | 'approved' | 'rejected';
 interface ShadowServerAccess {
     server: ShadowServer;
@@ -215,7 +420,6 @@ interface ShadowServer {
     description: string | null;
     iconUrl: string | null;
     bannerUrl: string | null;
-    homepageHtml: string | null;
     isPublic: boolean;
 }
 interface ShadowUser {
@@ -385,7 +589,15 @@ interface ShadowChannelPolicy {
     listen: boolean;
     reply: boolean;
     mentionOnly: boolean;
-    config: Record<string, unknown>;
+    config: ShadowChannelPolicyConfig;
+}
+interface ShadowChannelPolicyConfig {
+    allowedTriggerUserIds?: string[];
+    triggerUserIds?: string[];
+    ownerId?: string;
+    activeTenantIds?: string[];
+    replyRequiresMention?: boolean;
+    [key: string]: unknown;
 }
 interface ShadowSlashCommand {
     name: string;
@@ -401,6 +613,20 @@ interface ShadowChannelSlashCommand extends ShadowSlashCommand {
     botUsername: string;
     botDisplayName?: string | null;
 }
+interface ShadowChannelBootstrap {
+    access: ShadowChannelAccess;
+    channel: ShadowChannel;
+    server: ShadowServer | null;
+    channels: ShadowChannel[];
+    members: ShadowMember[];
+    messages: {
+        messages: ShadowMessage[];
+        hasMore: boolean;
+    };
+    slashCommands: {
+        commands: ShadowChannelSlashCommand[];
+    };
+}
 interface ShadowRemoteChannel {
     id: string;
     name: string;
@@ -418,6 +644,11 @@ interface ShadowRemoteServer {
 interface ShadowRemoteConfig {
     agentId: string;
     botUserId: string;
+    ownerId?: string;
+    buddyMode?: 'private' | 'shareable';
+    allowedServerIds?: string[];
+    activeTenantIds?: string[];
+    allowedTriggerUserIds?: string[];
     slashCommands?: ShadowSlashCommand[];
     servers: ShadowRemoteServer[];
 }
@@ -510,6 +741,15 @@ interface PolicyChangedPayload {
     serverId: string;
     channelId?: string | null;
 }
+interface VoiceParticipantPayload {
+    channelId: string;
+    participant: ShadowVoiceParticipant | null;
+    state: ShadowVoiceState;
+}
+interface VoicePolicyUpdatedPayload {
+    channelId: string;
+    agentId: string;
+}
 interface ShadowFriendship {
     id: string;
     userId: string;
@@ -668,6 +908,8 @@ interface ShadowCommerceProductCard {
         name: string;
         summary?: string | null;
         imageUrl?: string | null;
+        shopName?: string | null;
+        deliveryPromise?: string | null;
         price: number;
         currency: string;
         productType: 'physical' | 'entitlement';
@@ -761,6 +1003,68 @@ interface ShadowEntitlement {
         sizeBytes?: number | null;
         previewUrl?: string | null;
     } | null;
+    buyer?: {
+        id: string;
+        username: string;
+        displayName?: string | null;
+        avatarUrl?: string | null;
+    } | null;
+    order?: (Omit<ShadowOrder, 'items' | 'currency'> & {
+        currency?: string | null;
+        items?: ShadowOrder['items'];
+    }) | null;
+    fulfillmentJobs?: Array<Record<string, unknown>>;
+}
+interface ShadowOAuthCommerceEntitlementSummary {
+    id: string;
+    status: string;
+    capability: string;
+    resourceType: string;
+    resourceId: string;
+    productId?: string | null;
+    shopId?: string | null;
+    orderId?: string | null;
+    offerId?: string | null;
+    expiresAt?: string | null;
+}
+interface ShadowOAuthCommerceEntitlementAccess {
+    allowed: boolean;
+    status: string;
+    reasonCode?: string | null;
+    resourceType: string;
+    resourceId: string;
+    capability: string;
+    app: {
+        id: string;
+    };
+    entitlement?: ShadowOAuthCommerceEntitlementSummary | null;
+}
+interface ShadowOAuthCommerceEntitlementRedeemInput {
+    idempotencyKey: string;
+    resourceType?: string;
+    resourceId?: string;
+    capability?: string;
+    metadata?: Record<string, string | number | boolean | null>;
+}
+interface ShadowOAuthCommerceEntitlementRedemption {
+    appId: string;
+    resourceType: string;
+    resourceId: string;
+    capability: string;
+    idempotencyKey: string;
+    redeemedAt: string;
+    metadata?: Record<string, string | number | boolean | null>;
+}
+interface ShadowOAuthCommerceEntitlementRedeemResult {
+    redeemed: true;
+    resourceType: string;
+    resourceId: string;
+    capability: string;
+    app: {
+        id: string;
+    };
+    entitlement: ShadowOAuthCommerceEntitlementSummary;
+    redemption: ShadowOAuthCommerceEntitlementRedemption;
 }
 interface ShadowEntitlementPurchaseResult {
     order: {
@@ -842,6 +1146,80 @@ interface ShadowCommerceCheckoutPreview {
     };
     nextAction: 'purchase' | 'open_paid_file' | 'view_entitlement' | string;
 }
+interface ShadowCommerceProductContext {
+    product: ShadowProduct;
+    shop: ShadowShop & {
+        logoUrl?: string | null;
+        bannerUrl?: string | null;
+    };
+    server: {
+        id: string;
+        name: string;
+        slug?: string | null;
+        description?: string | null;
+        iconUrl?: string | null;
+        bannerUrl?: string | null;
+        ownerId?: string | null;
+    } | null;
+    provider: {
+        id: string;
+        username: string;
+        displayName?: string | null;
+        avatarUrl?: string | null;
+        isBot?: boolean;
+    } | null;
+    buddy: {
+        id: string;
+        userId: string;
+        ownerId: string;
+        status: string;
+        totalOnlineSeconds?: number | null;
+        lastHeartbeat?: string | null;
+    } | null;
+    offer: {
+        id: string;
+        status: string;
+        priceOverride?: number | null;
+        currency: string;
+        allowedSurfaces?: string[] | null;
+        sellerUserId?: string | null;
+        sellerBuddyUserId?: string | null;
+    } | null;
+    fulfillment: {
+        status: string;
+        resourceType?: string | null;
+        resourceId?: string | null;
+        capability?: string | null;
+        deliverables: Array<{
+            id: string;
+            kind: string;
+            resourceType?: string | null;
+            resourceId?: string | null;
+            deliveryTiming?: string | null;
+            status: string;
+        }>;
+    };
+    refund: {
+        policy: string;
+        status: string;
+        supportPath?: string | null;
+    };
+    credit: {
+        salesCount: number;
+        avgRating: number;
+        ratingCount: number;
+        completedOrders: number;
+    };
+    links: {
+        product: string;
+        shop?: string | null;
+        server?: string | null;
+        providerProfile?: string | null;
+        buddyProfile?: string | null;
+        assetHome?: string | null;
+        checkoutPreview?: string | null;
+    };
+}
 interface ShadowPaidFileOpenResult {
     grant: {
         id: string;
@@ -858,18 +1236,54 @@ interface ShadowCategory {
     description?: string | null;
     position: number;
 }
+interface ShadowProductMedia {
+    id?: string;
+    type?: 'image' | 'video' | string;
+    url: string;
+    thumbnailUrl?: string | null;
+    position?: number;
+}
+interface ShadowProductSku {
+    id: string;
+    specValues: string[];
+    price: number;
+    stock: number;
+    imageUrl?: string | null;
+    skuCode?: string | null;
+    isActive?: boolean;
+}
+interface ShadowProductEntitlementConfig {
+    resourceType?: string;
+    resourceId?: string;
+    capability?: string;
+    durationSeconds?: number | null;
+    renewalPeriodSeconds?: number | null;
+    privilegeDescription?: string;
+}
 interface ShadowProduct {
     id: string;
     shopId: string;
     categoryId?: string | null;
     name: string;
+    slug?: string;
+    type?: 'physical' | 'entitlement' | string;
     description?: string | null;
-    price: number;
+    summary?: string | null;
+    price?: number;
+    basePrice?: number;
     currency: string;
-    stock: number;
+    stock?: number;
     status: string;
+    specNames?: string[];
+    tags?: string[];
+    salesCount?: number;
+    avgRating?: number;
+    ratingCount?: number;
     billingMode?: 'one_time' | 'fixed_duration' | 'subscription';
-    images: string[];
+    entitlementConfig?: ShadowProductEntitlementConfig | ShadowProductEntitlementConfig[] | null;
+    media?: ShadowProductMedia[];
+    skus?: ShadowProductSku[];
+    images?: string[];
     createdAt: string;
 }
 interface ShadowCartItem {
@@ -880,17 +1294,29 @@ interface ShadowCartItem {
 }
 interface ShadowOrder {
     id: string;
+    orderNo?: string;
     shopId: string;
     buyerId: string;
-    status: string;
+    status: 'pending' | 'paid' | 'processing' | 'shipped' | 'delivered' | 'completed' | 'cancelled' | 'refunded' | string;
     totalAmount: number;
     currency: string;
-    items: {
+    trackingNo?: string | null;
+    buyerNote?: string | null;
+    sellerNote?: string | null;
+    paidAt?: string | null;
+    shippedAt?: string | null;
+    completedAt?: string | null;
+    cancelledAt?: string | null;
+    items: Array<{
+        id?: string;
         productId: string;
         skuId?: string | null;
+        productName?: string;
+        specValues?: string[];
         quantity: number;
         price: number;
-    }[];
+        imageUrl?: string | null;
+    }>;
     createdAt: string;
 }
 interface ShadowReview {
@@ -1328,6 +1754,11 @@ interface ServerEventMap {
     'channel:member-added': (payload: ChannelMemberAddedPayload) => void;
     'channel:member-removed': (payload: ChannelMemberRemovedPayload) => void;
     'channel:slash-commands-updated': (payload: SlashCommandsUpdatedPayload) => void;
+    'voice:state': (payload: ShadowVoiceState) => void;
+    'voice:participant-joined': (payload: VoiceParticipantPayload) => void;
+    'voice:participant-left': (payload: VoiceParticipantPayload) => void;
+    'voice:participant-updated': (payload: VoiceParticipantPayload) => void;
+    'voice:policy-updated': (payload: VoicePolicyUpdatedPayload) => void;
     'server:joined': (payload: ServerJoinedPayload) => void;
     'agent:policy-changed': (payload: PolicyChangedPayload) => void;
     error: (payload: {
@@ -1344,6 +1775,52 @@ interface ClientEventMap {
     'channel:leave': (data: {
         channelId: string;
     }) => void;
+    'voice:join': (data: {
+        channelId: string;
+        clientId?: string;
+        muted?: boolean;
+        deafened?: boolean;
+    }, ack?: (res: {
+        ok: boolean;
+        data?: ShadowVoiceJoinResult;
+        error?: string;
+        code?: string;
+    }) => void) => void;
+    'voice:leave': (data: {
+        channelId: string;
+        clientId?: string | null;
+    }, ack?: (res: {
+        ok: boolean;
+        data?: ShadowVoiceLeaveResult;
+        error?: string;
+        code?: string;
+    }) => void) => void;
+    'voice:state:update': (data: {
+        channelId: string;
+        clientId?: string | null;
+        muted?: boolean;
+        deafened?: boolean;
+        speaking?: boolean;
+        screenSharing?: boolean;
+    }, ack?: (res: {
+        ok: boolean;
+        data?: unknown;
+        error?: string;
+        code?: string;
+    }) => void) => void;
+    'voice:token:renew': (data: {
+        channelId: string;
+        clientId?: string | null;
+    }, ack?: (res: {
+        ok: boolean;
+        data?: ShadowVoiceRenewResult;
+        error?: string;
+        code?: string;
+    }) => void) => void;
+    'voice:heartbeat': (data: {
+        channelId: string;
+        clientId?: string | null;
+    }) => void;
     'message:send': (data: {
         channelId: string;
         content: string;
@@ -1426,10 +1903,15 @@ declare class ShadowClient {
     getOfficialModelProxyBilling(): Promise<ShadowModelProxyBilling>;
     createOfficialChatCompletion(data: ShadowModelProxyChatCompletionRequest): Promise<ShadowModelProxyChatCompletionResponse>;
     createOfficialChatCompletionStream(data: ShadowModelProxyChatCompletionRequest): Promise<Response>;
-    listAgents(): Promise<{
+    listAgents(options?: {
+        includeRentals?: boolean;
+    }): Promise<{
         id: string;
-        name: string;
+        name?: string;
         status: string;
+        accessRole?: 'owner' | 'tenant';
+        activeContractId?: string | null;
+        config?: Record<string, unknown>;
     }[]>;
     createAgent(data: {
         name: string;
@@ -1439,6 +1921,8 @@ declare class ShadowClient {
         avatarUrl?: string | null;
         kernelType?: string;
         config?: Record<string, unknown>;
+        buddyMode?: 'private' | 'shareable';
+        allowedServerIds?: string[];
     }): Promise<{
         id: string;
         token: string;
@@ -1454,6 +1938,8 @@ declare class ShadowClient {
         name?: string;
         displayName?: string;
         avatarUrl?: string | null;
+        buddyMode?: 'private' | 'shareable';
+        allowedServerIds?: string[];
     }): Promise<{
         id: string;
         name: string;
@@ -1524,14 +2010,50 @@ declare class ShadowClient {
     listServers(): Promise<ShadowServer[]>;
     getServer(serverIdOrSlug: string): Promise<ShadowServer>;
     getServerAccess(serverIdOrSlug: string): Promise<ShadowServerAccess>;
+    listServerApps(serverIdOrSlug: string): Promise<ShadowServerAppIntegration[]>;
+    listServerAppCatalog(serverIdOrSlug: string): Promise<ShadowServerAppCatalogEntry[]>;
+    discoverServerApp(serverIdOrSlug: string, data: {
+        manifestUrl?: string;
+        manifest?: ShadowServerAppManifest;
+    }): Promise<ShadowServerAppDiscovery>;
+    installServerApp(serverIdOrSlug: string, data: {
+        manifestUrl?: string;
+        manifest?: ShadowServerAppManifest;
+    }): Promise<ShadowServerAppIntegration>;
+    installServerAppFromCatalog(serverIdOrSlug: string, catalogEntryId: string, data?: Record<string, never>): Promise<ShadowServerAppIntegration>;
+    getServerApp(serverIdOrSlug: string, appKey: string): Promise<ShadowServerAppIntegration & {
+        grants?: Record<string, unknown>[];
+    }>;
+    deleteServerApp(serverIdOrSlug: string, appKey: string): Promise<{
+        ok: boolean;
+    }>;
+    grantServerAppToBuddy(serverIdOrSlug: string, appKey: string, data: {
+        buddyAgentId: string;
+        permissions: string[];
+        resourceRules?: Record<string, unknown>;
+        approvalMode?: 'none' | 'first_time' | 'every_time' | 'policy';
+        expiresAt?: string;
+    }): Promise<Record<string, unknown>>;
+    getServerAppSkills(serverIdOrSlug: string, appKey: string): Promise<ShadowServerAppSkillDocument>;
+    createServerAppLaunch(serverIdOrSlug: string, appKey: string): Promise<ShadowServerAppLaunchContext>;
+    introspectServerAppToken(serverIdOrSlug: string, appKey: string, token: string): Promise<ShadowServerAppTokenIntrospection>;
+    callServerAppCommand(serverIdOrSlug: string, appKey: string, commandName: string, data?: {
+        input?: unknown;
+        channelId?: string;
+    }): Promise<unknown>;
+    callServerAppCommandMultipart(serverIdOrSlug: string, appKey: string, commandName: string, data: {
+        input?: unknown;
+        channelId?: string;
+        file: Blob;
+        filename: string;
+        field?: string;
+    }): Promise<unknown>;
     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;
     }>;
@@ -1564,6 +2086,9 @@ declare class ShadowClient {
         isPrivate?: boolean;
     }): Promise<ShadowChannel>;
     getChannel(channelId: string): Promise<ShadowChannel>;
+    getChannelBootstrap(channelId: string, options?: {
+        messagesLimit?: number;
+    }): Promise<ShadowChannelBootstrap>;
     getChannelAccess(channelId: string): Promise<ShadowChannelAccess>;
     getChannelMembers(channelId: string): Promise<ShadowMember[]>;
     updateChannel(channelId: string, data: {
@@ -1586,6 +2111,37 @@ declare class ShadowClient {
     removeChannelMember(channelId: string, userId: string): Promise<{
         success: boolean;
     }>;
+    getVoiceState(channelId: string): Promise<ShadowVoiceState>;
+    joinVoiceChannel(channelId: string, options?: {
+        clientId?: string | null;
+        muted?: boolean;
+        deafened?: boolean;
+    }): Promise<ShadowVoiceJoinResult>;
+    renewVoiceCredentials(channelId: string, options?: {
+        clientId?: string | null;
+    }): Promise<ShadowVoiceRenewResult>;
+    leaveVoiceChannel(channelId: string, options?: {
+        clientId?: string | null;
+    }): Promise<ShadowVoiceLeaveResult>;
+    updateVoiceState(channelId: string, data: {
+        clientId?: string | null;
+        muted?: boolean;
+        deafened?: boolean;
+        speaking?: boolean;
+        screenSharing?: boolean;
+    }): Promise<{
+        participant: unknown;
+        state: ShadowVoiceState;
+    }>;
+    getVoicePolicy(channelId: string, agentId: string): Promise<ShadowVoicePolicy>;
+    updateVoicePolicy(channelId: string, data: {
+        agentId: string;
+        listen?: boolean;
+        autoJoin?: boolean;
+        consumeAudio?: boolean;
+        consumeScreenShare?: boolean;
+        screenshotIntervalSeconds?: number | null;
+    }): Promise<ShadowVoicePolicy>;
     setBuddyPolicy(channelId: string, agentId: string, data: {
         mentionOnly?: boolean;
         reply?: boolean;
@@ -1699,6 +2255,11 @@ declare class ShadowClient {
     }>;
     resolveAttachmentMediaUrl(attachmentId: string, options?: {
         disposition?: 'inline' | 'attachment';
+        variant?: ShadowMediaVariant;
+    }): Promise<ShadowSignedMediaUrl>;
+    resolveWorkspaceMediaUrl(serverId: string, fileId: string, options?: {
+        disposition?: 'inline' | 'attachment';
+        contentRef?: string;
     }): Promise<ShadowSignedMediaUrl>;
     /**
      * Download a file from a URL and upload it to the Shadow media service.
@@ -1788,11 +2349,28 @@ declare class ShadowClient {
     listOAuthAccounts(): Promise<{
         id: string;
         provider: string;
-        providerAccountId: string;
+        providerEmail: string | null;
+        createdAt: string;
     }[]>;
+    createOAuthConnectUrl(provider: 'google' | 'github', redirect?: string): Promise<{
+        url: string;
+    }>;
     unlinkOAuthAccount(accountId: string): Promise<{
         success: boolean;
     }>;
+    listAuthSessions(): Promise<Array<{
+        id: string;
+        deviceName: string | null;
+        userAgent: string | null;
+        ipAddress: string | null;
+        lastSeenAt: string;
+        createdAt: string;
+        revokedAt: string | null;
+        current: boolean;
+    }>>;
+    revokeAuthSession(sessionId: string): Promise<{
+        ok: boolean;
+    }>;
     changePassword(data: {
         currentPassword: string;
         newPassword: string;
@@ -1883,6 +2461,18 @@ declare class ShadowClient {
     revokeOAuthConsent(appId: string): Promise<{
         success: boolean;
     }>;
+    sendOAuthChannelMessage(channelId: string, content: string, opts?: {
+        metadata?: {
+            oauthLinkCards?: ShadowOAuthLinkCard[];
+        };
+    }): Promise<ShadowMessage>;
+    sendOAuthBuddyMessage(buddyId: string, data: {
+        channelId: string;
+        content: string;
+        metadata?: {
+            oauthLinkCards?: ShadowOAuthLinkCard[];
+        };
+    }): Promise<ShadowMessage>;
     browseListings(params?: {
         search?: string;
         tags?: string[];
@@ -1954,6 +2544,7 @@ declare class ShadowClient {
         products: ShadowProduct[];
     }>;
     getScopeNeutralProduct(productId: string): Promise<ShadowProduct>;
+    getCommerceProductContext(productId: string): Promise<ShadowCommerceProductContext>;
     getShopProduct(shopId: string, productId: string): Promise<ShadowProduct>;
     createShopProduct(shopId: string, data: Partial<ShadowProduct> & Record<string, unknown>): Promise<ShadowProduct>;
     updateShopProduct(shopId: string, productId: string, data: Partial<ShadowProduct> & Record<string, unknown>): Promise<ShadowProduct>;
@@ -2048,14 +2639,8 @@ declare class ShadowClient {
         total: number;
     }>;
     getProduct(serverId: string, productId: string): Promise<ShadowProduct>;
-    createProduct(serverId: string, data: {
+    createProduct(serverId: string, data: Partial<ShadowProduct> & {
         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;
@@ -2065,6 +2650,7 @@ declare class ShadowClient {
         status: string;
         categoryId: string | null;
         images: string[];
+        media: ShadowProduct['media'];
     }>): Promise<ShadowProduct>;
     deleteProduct(serverId: string, productId: string): Promise<{
         success: boolean;
@@ -2085,12 +2671,14 @@ declare class ShadowClient {
             skuId?: string;
             quantity: number;
         }[];
+        buyerNote?: string;
     }): 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>;
+    completeOrder(serverId: string, orderId: string): Promise<ShadowOrder>;
     getProductReviews(serverId: string, productId: string): Promise<ShadowReview[]>;
     createReview(serverId: string, orderId: string, data: {
         productId: string;
@@ -2294,12 +2882,20 @@ declare class ShadowClient {
     confirmRechargePayment(paymentIntentId: string): Promise<ShadowPaymentOrder>;
     getEntitlements(serverId: string): Promise<ShadowEntitlement[]>;
     getAllEntitlements(): Promise<ShadowEntitlement[]>;
+    getEntitlement(entitlementId: string): Promise<ShadowEntitlement>;
+    getOAuthCommerceEntitlementAccess(params?: {
+        resourceType?: string;
+        resourceId?: string;
+        capability?: string;
+    }): Promise<ShadowOAuthCommerceEntitlementAccess>;
+    redeemOAuthCommerceEntitlement(data: ShadowOAuthCommerceEntitlementRedeemInput): Promise<ShadowOAuthCommerceEntitlementRedeemResult>;
     verifyEntitlement(entitlementId: string): Promise<{
         active: boolean;
         entitlement: Record<string, unknown>;
         provisioning: ShadowEntitlementProvisioning;
     }>;
     cancelEntitlement(entitlementId: string, reason?: string): Promise<Record<string, unknown>>;
+    cancelEntitlementRenewal(entitlementId: string, reason?: string): Promise<Record<string, unknown>>;
     getTaskCenter(): Promise<{
         tasks: ShadowTask[];
     }>;
@@ -2357,6 +2953,14 @@ declare class ShadowClient {
         items: Record<string, unknown>[];
         total: number;
     }>;
+    discoverCommerce(params?: {
+        q?: string;
+        limit?: number;
+    }): Promise<Record<string, unknown>>;
+    discoverBusinessHub(params?: {
+        q?: string;
+        limit?: number;
+    }): Promise<Record<string, unknown>>;
     enhanceVoice(data: {
         transcript: string;
         language?: string;
@@ -2485,6 +3089,47 @@ declare class ShadowSocket {
     }>;
     /** Leave a channel room */
     leaveChannel(channelId: string): void;
+    joinVoiceChannel(channelId: string, options?: {
+        clientId?: string;
+        muted?: boolean;
+        deafened?: boolean;
+    }): Promise<{
+        ok: boolean;
+        data?: ShadowVoiceJoinResult;
+        error?: string;
+        code?: string;
+    }>;
+    leaveVoiceChannel(channelId: string, options?: {
+        clientId?: string | null;
+    }): Promise<{
+        ok: boolean;
+        data?: ShadowVoiceLeaveResult;
+        error?: string;
+        code?: string;
+    }>;
+    renewVoiceCredentials(channelId: string, options?: {
+        clientId?: string | null;
+    }): Promise<{
+        ok: boolean;
+        data?: ShadowVoiceRenewResult;
+        error?: string;
+        code?: string;
+    }>;
+    updateVoiceState(channelId: string, data: {
+        clientId?: string | null;
+        muted?: boolean;
+        deafened?: boolean;
+        speaking?: boolean;
+        screenSharing?: boolean;
+    }): Promise<{
+        ok: boolean;
+        data?: unknown;
+        error?: string;
+        code?: string;
+    }>;
+    sendVoiceHeartbeat(channelId: string, options?: {
+        clientId?: string | null;
+    }): void;
     /** Send a message via WebSocket (text-only; for file attachments use REST) */
     sendMessage(data: {
         channelId: string;
@@ -2502,4 +3147,40 @@ declare class ShadowSocket {
     updateActivity(channelId: string, activity: string | null): void;
 }
 
-export { type ChannelCreatedPayload, type ChannelMemberAddedPayload, type ChannelMemberRemovedPayload, type ClientEventMap, type MemberJoinPayload, type MemberLeavePayload, type MessageDeletedPayload, type PolicyChangedPayload, type PresenceActivityPayload, type PresenceChangePayload, type ReactionPayload, type ServerEventMap, type ServerJoinedPayload, type ShadowAddAgentsToServerResult, type ShadowAgentUsageSnapshotInput, type ShadowAttachment, type ShadowCartItem, type ShadowCategory, type ShadowChannel, type ShadowChannelAccess, type ShadowChannelJoinRequestResult, type ShadowChannelJoinRequestStatus, type ShadowChannelPolicy, type ShadowChannelSlashCommand, ShadowClient, type ShadowCloudDeploymentBackup, type ShadowCloudDeploymentRuntimeResponse, type ShadowCloudDeploymentStatus, type ShadowCloudProviderCatalog, type ShadowCloudProviderEnvVar, type ShadowCloudProviderModel, type ShadowCloudProviderProfile, type ShadowContract, type ShadowDiyCloudRun, type ShadowDiyCloudRunEvent, type ShadowDiyCloudRunStatus, type ShadowFriendship, type ShadowInteractiveActionInput, type ShadowInteractiveActionResult, type ShadowInteractiveBlock, type ShadowInteractiveResponse, type ShadowInteractiveState, type ShadowInteractiveSubmissionPending, type ShadowInviteCode, type ShadowListing, type ShadowMember, type ShadowMentionSuggestion, type ShadowMentionSuggestionTrigger, type ShadowMessage, type ShadowMessageMention, type ShadowModelProxyBilling, type ShadowModelProxyChatCompletionRequest, type ShadowModelProxyChatCompletionResponse, type ShadowModelProxyModel, type ShadowModelProxyModelsResponse, 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 ShadowServerAccess, type ShadowServerJoinRequestResult, type ShadowServerJoinRequestStatus, type ShadowShop, type ShadowSlashCommand, ShadowSocket, type ShadowSocketOptions, type ShadowTask, type ShadowThread, type ShadowTransaction, type ShadowUsageProviderSnapshot, type ShadowUser, type ShadowWallet, type TypingPayload, channelRoom, threadRoom, userRoom };
+interface ShadowVoiceConsumerOptions {
+    client: ShadowClient;
+    channelId: string;
+    clientId?: string;
+    muted?: boolean;
+    onRemoteAudio?: (input: {
+        uid: string | number;
+        track: IRemoteAudioTrack;
+    }) => void;
+    onRemoteScreen?: (input: {
+        uid: string | number;
+        track: IRemoteVideoTrack;
+    }) => void;
+}
+declare class ShadowVoiceConsumer {
+    private options;
+    private rtc;
+    private screenRtc;
+    private audioTrack;
+    private screenTrack;
+    private session;
+    private readonly clientId;
+    private tokenRenewTimer;
+    constructor(options: ShadowVoiceConsumerOptions);
+    get joinResult(): ShadowVoiceJoinResult | null;
+    join(): Promise<ShadowVoiceJoinResult>;
+    setMuted(muted: boolean): Promise<void>;
+    startScreenShare(): Promise<void>;
+    stopScreenShare(): Promise<void>;
+    leave(): Promise<void>;
+    private bindTokenRenewal;
+    private scheduleTokenRenewal;
+    private clearTokenRenewal;
+    private renewTokens;
+}
+
+export { type ChannelCreatedPayload, type ChannelMemberAddedPayload, type ChannelMemberRemovedPayload, type ClientEventMap, type MemberJoinPayload, type MemberLeavePayload, type MessageDeletedPayload, type PolicyChangedPayload, type PresenceActivityPayload, type PresenceChangePayload, type ReactionPayload, type ServerEventMap, type ServerJoinedPayload, type ShadowAddAgentsToServerResult, type ShadowAgentUsageSnapshotInput, type ShadowAttachment, type ShadowCartItem, type ShadowCategory, type ShadowChannel, type ShadowChannelAccess, type ShadowChannelBootstrap, type ShadowChannelJoinRequestResult, type ShadowChannelJoinRequestStatus, type ShadowChannelPolicy, type ShadowChannelSlashCommand, ShadowClient, type ShadowCloudDeploymentBackup, type ShadowCloudDeploymentRuntimeResponse, type ShadowCloudDeploymentStatus, type ShadowCloudProviderCatalog, type ShadowCloudProviderEnvVar, type ShadowCloudProviderModel, type ShadowCloudProviderProfile, type ShadowCommerceCheckoutPreview, type ShadowCommerceProductCard, type ShadowCommerceProductContext, type ShadowCommerceProductPickerGroup, type ShadowCommerceProductPickerResponse, type ShadowCommunityAsset, type ShadowCommunityAssetDefinition, type ShadowCommunityAssetGrant, type ShadowContract, type ShadowDiyCloudRun, type ShadowDiyCloudRunEvent, type ShadowDiyCloudRunStatus, type ShadowFriendship, type ShadowInteractiveActionInput, type ShadowInteractiveActionResult, type ShadowInteractiveBlock, type ShadowInteractiveResponse, type ShadowInteractiveState, type ShadowInteractiveSubmissionPending, type ShadowInviteCode, type ShadowListing, type ShadowMediaVariant, type ShadowMember, type ShadowMentionSuggestion, type ShadowMentionSuggestionTrigger, type ShadowMessage, type ShadowMessageMention, type ShadowModelProxyBilling, type ShadowModelProxyChatCompletionRequest, type ShadowModelProxyChatCompletionResponse, type ShadowModelProxyModel, type ShadowModelProxyModelsResponse, type ShadowNotification, type ShadowNotificationPreferences, type ShadowOAuthApp, type ShadowOAuthCommerceEntitlementAccess, type ShadowOAuthCommerceEntitlementRedeemInput, type ShadowOAuthCommerceEntitlementRedeemResult, type ShadowOAuthCommerceEntitlementRedemption, type ShadowOAuthCommerceEntitlementSummary, type ShadowOAuthConsent, type ShadowOAuthToken, type ShadowOrder, type ShadowPaidFileOpenResult, type ShadowProduct, type ShadowProductEntitlementConfig, type ShadowProductMedia, type ShadowProductSku, type ShadowRemoteChannel, type ShadowRemoteConfig, type ShadowRemoteServer, type ShadowReview, type ShadowServer, type ShadowServerAccess, type ShadowServerAppCatalogEntry, type ShadowServerAppCommand, type ShadowServerAppDiscovery, type ShadowServerAppIntegration, type ShadowServerAppLaunchContext, type ShadowServerAppManifest, type ShadowServerAppSkillDocument, type ShadowServerAppTokenIntrospection, type ShadowServerJoinRequestResult, type ShadowServerJoinRequestStatus, type ShadowSettlementLine, type ShadowShop, type ShadowSlashCommand, ShadowSocket, type ShadowSocketOptions, type ShadowTask, type ShadowThread, type ShadowTransaction, type ShadowUsageProviderSnapshot, type ShadowUser, ShadowVoiceConsumer, type ShadowVoiceConsumerOptions, type ShadowVoiceCredentials, type ShadowVoiceJoinResult, type ShadowVoiceLeaveResult, type ShadowVoiceParticipant, type ShadowVoicePolicy, type ShadowVoiceState, type ShadowWallet, type TypingPayload, type VoiceParticipantPayload, type VoicePolicyUpdatedPayload, channelRoom, threadRoom, userRoom };