@shadowob/sdk 1.1.0 → 1.1.3-dev.251

package/dist/index.d.cts

@@ -1,5 +1,6 @@
-import { Socket } from 'socket.io-client';
+import { MessageMention, MentionSuggestionTrigger, MentionSuggestion } from '@shadowob/shared';
 export { CLIENT_EVENTS, ClientEvent, SERVER_EVENTS, ServerEvent } from '@shadowob/shared';
+import { Socket } from 'socket.io-client';
 
 /** Message returned by the Shadow REST API and Socket.IO broadcasts */
 interface ShadowMessage {
@@ -20,7 +21,89 @@ interface ShadowMessage {
         isBot?: boolean;
     };
     attachments?: ShadowAttachment[];
+    metadata?: ShadowMessageMetadata | null;
+}
+interface ShadowInteractiveButtonItem {
+    id: string;
+    label: string;
+    style?: 'primary' | 'secondary' | 'destructive';
+    value?: string;
+}
+interface ShadowInteractiveSelectItem {
+    id: string;
+    label: string;
+    value: string;
+}
+interface ShadowInteractiveFormField {
+    id: string;
+    kind: 'text' | 'textarea' | 'number' | 'checkbox' | 'select';
+    label: string;
+    placeholder?: string;
+    defaultValue?: string;
+    required?: boolean;
+    options?: ShadowInteractiveSelectItem[];
+    maxLength?: number;
+    min?: number;
+    max?: number;
+}
+interface ShadowInteractiveBlock {
+    id: string;
+    kind: 'buttons' | 'select' | 'form' | 'approval';
+    prompt?: string;
+    buttons?: ShadowInteractiveButtonItem[];
+    options?: ShadowInteractiveSelectItem[];
+    fields?: ShadowInteractiveFormField[];
+    submitLabel?: string;
+    responsePrompt?: string;
+    approvalCommentLabel?: string;
+    oneShot?: boolean;
+}
+interface ShadowInteractiveResponse {
+    blockId: string;
+    sourceMessageId: string;
+    actionId: string;
+    value: string;
+    values?: Record<string, string>;
+    submissionId?: string;
+    responseMessageId?: string | null;
+    submittedAt?: string;
+}
+interface ShadowInteractiveState {
+    sourceMessageId: string;
+    blockId: string;
+    submitted: boolean;
+    response?: ShadowInteractiveResponse;
+}
+interface ShadowInteractiveActionInput {
+    blockId: string;
+    actionId: string;
+    value?: string;
+    label?: string;
+    values?: Record<string, string>;
 }
+interface ShadowInteractiveSubmissionPending {
+    ok: true;
+    pending: true;
+    interactiveState?: ShadowInteractiveState;
+}
+type ShadowInteractiveActionResult = ShadowMessage | ShadowInteractiveSubmissionPending;
+interface ShadowMessageMetadata {
+    mentions?: ShadowMessageMention[];
+    agentChain?: Record<string, unknown>;
+    interactive?: ShadowInteractiveBlock;
+    interactiveResponse?: ShadowInteractiveResponse;
+    interactiveState?: ShadowInteractiveState;
+    commerceCards?: Array<ShadowCommerceProductCard | ShadowCommerceOfferCardInput>;
+    [key: string]: unknown;
+}
+interface ShadowCommerceOfferCardInput {
+    id?: string;
+    kind: 'offer';
+    offerId: string;
+}
+type ShadowMessageMention = MessageMention;
+type ShadowMentionSuggestion = MentionSuggestion;
+type ShadowMentionSuggestionTrigger = MentionSuggestionTrigger;
 interface ShadowAttachment {
     id: string;
     filename: string;
@@ -29,20 +112,54 @@ interface ShadowAttachment {
     size: number;
     width?: number | null;
     height?: number | null;
+    workspaceNodeId?: string | null;
+}
+interface ShadowSignedMediaUrl {
+    url: string;
+    expiresAt: string;
 }
 interface ShadowChannel {
     id: string;
     name: string;
     type: string;
-    serverId: string;
+    kind: 'server' | 'dm';
+    serverId: string | null;
     description?: string | null;
     position?: number;
+    isPrivate?: boolean;
+    isMember?: boolean;
+    otherUser?: ShadowUser | null;
 }
-interface ShadowDmChannel {
-    id: string;
-    user1Id: string;
-    user2Id: string;
-    createdAt: string;
+type ShadowChannelJoinRequestStatus = 'pending' | 'approved' | 'rejected';
+interface ShadowChannelAccess {
+    channel: ShadowChannel;
+    isServerMember: boolean;
+    isChannelMember: boolean;
+    canManage: boolean;
+    canAccess: boolean;
+    requiresApproval: boolean;
+    joinRequestStatus: ShadowChannelJoinRequestStatus | null;
+    joinRequestId: string | null;
+}
+interface ShadowChannelJoinRequestResult {
+    ok: boolean;
+    status: ShadowChannelJoinRequestStatus;
+    requestId?: string;
+}
+type ShadowServerJoinRequestStatus = 'pending' | 'approved' | 'rejected';
+interface ShadowServerAccess {
+    server: ShadowServer;
+    isMember: boolean;
+    canManage: boolean;
+    canAccess: boolean;
+    requiresApproval: boolean;
+    joinRequestStatus: ShadowServerJoinRequestStatus | null;
+    joinRequestId: string | null;
+}
+interface ShadowServerJoinRequestResult {
+    ok: boolean;
+    status: ShadowServerJoinRequestStatus;
+    requestId?: string;
 }
 interface ShadowThread {
     id: string;
@@ -55,8 +172,32 @@ interface ShadowMember {
     userId: string;
     serverId: string;
     role: string;
+    isBot?: boolean;
+    uid?: string;
+    nickname?: string;
+    avatar?: string | null;
+    status?: 'online' | 'idle' | 'dnd' | 'offline';
+    membershipTier?: string;
+    membershipLevel?: number;
+    isMember?: boolean;
+    totalOnlineSeconds?: number;
+    buddyTag?: string | null;
+    creator?: {
+        uid: string;
+        nickname: string;
+        username?: string;
+        displayName?: string | null;
+        avatarUrl?: string | null;
+    } | null;
     user?: ShadowUser;
 }
+interface ShadowAddAgentsToServerResult {
+    added: string[];
+    failed: Array<{
+        agentId: string;
+        error: string;
+    }>;
+}
 interface ShadowInviteCode {
     id: string;
     code: string;
@@ -79,22 +220,166 @@ interface ShadowServer {
 }
 interface ShadowUser {
     id: string;
+    email?: string;
     username: string;
     displayName?: string;
     avatarUrl?: string;
     isBot?: boolean;
     agentId?: string;
+    membership?: ShadowMembership;
+}
+interface ShadowMembership {
+    status: string;
+    tier: {
+        id: string;
+        level: number;
+        label: string;
+        capabilities: string[];
+    };
+    level: number;
+    isMember: boolean;
+    memberSince?: string | null;
+    inviteCodeId?: string | null;
+    capabilities: string[];
+}
+interface ShadowAuthResponse {
+    user: ShadowUser;
+    accessToken: string;
+    refreshToken: string;
+}
+type ShadowPlayAction = {
+    kind: 'public_channel';
+    serverId?: string;
+    serverSlug?: string;
+    channelId?: string;
+    channelName?: string;
+    inviteCode?: string;
+    buddyUserIds?: string[];
+    buddyTemplateSlug?: string;
+    greeting?: string;
+} | {
+    kind: 'private_room';
+    serverId?: string;
+    serverSlug?: string;
+    namePrefix?: string;
+    buddyUserIds?: string[];
+    buddyTemplateSlug?: string;
+    greeting?: string;
+} | {
+    kind: 'cloud_deploy';
+    templateSlug: string;
+    buddyTemplateSlug?: string;
+    buddyUserIds?: string[];
+    greeting?: string;
+    resourceTier?: 'lightweight' | 'standard' | 'pro';
+    defaultChannelName?: string;
+} | {
+    kind: 'external_oauth_app';
+    clientId: string;
+    redirectUri: string;
+    scopes?: string[];
+    state?: string;
+} | {
+    kind: 'landing_page';
+    url: string;
+};
+type ShadowPlayAvailability = 'available' | 'gated' | 'coming_soon' | 'misconfigured';
+interface ShadowHomePlayCatalogItem {
+    id: string;
+    image: string;
+    title: string;
+    titleEn: string;
+    desc: string;
+    descEn: string;
+    category: string;
+    categoryEn: string;
+    starts: string;
+    accentColor: string;
+    hot?: boolean;
+    status: ShadowPlayAvailability;
+    action?: ShadowPlayAction;
+    gates?: {
+        auth?: 'optional' | 'required';
+        membership?: 'none' | 'required';
+        profile?: 'optional' | 'required';
+    };
+    template?: {
+        kind: 'cloud';
+        slug: string;
+        path: string;
+    };
+    materials?: {
+        cover: string;
+    };
+}
+interface ShadowPlayLaunchResult {
+    ok: boolean;
+    status: string;
+    playId?: string | null;
+    redirectUrl?: string;
+    serverId?: string;
+    channelId?: string;
+    deploymentId?: string;
+    deploymentStatus?: string;
+    templateSlug?: string;
+}
+interface ShadowModelProxyModel {
+    id: string;
+    object: 'model';
+    created: number;
+    owned_by: string;
+}
+interface ShadowModelProxyModelsResponse {
+    object: 'list';
+    data: ShadowModelProxyModel[];
+}
+interface ShadowModelProxyBilling {
+    enabled: boolean;
+    currency: 'shrimp';
+    model: string;
+    models: string[];
+    shrimpMicrosPerCoin: number;
+    shrimpPerCny: number;
+    inputTokensPerShrimp: number | null;
+    outputTokensPerShrimp: number | null;
+    inputCacheHitCnyPerMillionTokens: number;
+    inputCacheMissCnyPerMillionTokens: number;
+    outputCnyPerMillionTokens: number;
+    inputCacheHitShrimpPerMillionTokens: number;
+    inputCacheMissShrimpPerMillionTokens: number;
+    outputShrimpPerMillionTokens: number;
 }
+type ShadowModelProxyChatCompletionRequest = Record<string, unknown> & {
+    model?: string;
+    messages: unknown[];
+    stream?: boolean;
+};
+type ShadowModelProxyChatCompletionResponse = Record<string, unknown>;
 interface ShadowNotification {
     id: string;
     userId: string;
     type: string;
+    kind?: string | null;
     title: string;
-    body: string;
-    referenceId?: string;
-    referenceType?: string;
+    body: string | null;
+    referenceId?: string | null;
+    referenceType?: string | null;
+    senderId?: string | null;
+    senderAvatarUrl?: string | null;
+    scopeServerId?: string | null;
+    scopeChannelId?: string | null;
+    aggregationKey?: string | null;
+    aggregatedCount?: number | null;
+    lastAggregatedAt?: string | null;
+    metadata?: Record<string, unknown> | null;
     isRead: boolean;
     createdAt: string;
+    expiresAt?: string | null;
+}
+interface ShadowScopedUnread {
+    channelUnread: Record<string, number>;
+    serverUnread: Record<string, number>;
+    dmUnread?: Record<string, number>;
 }
 interface ShadowChannelPolicy {
     listen: boolean;
@@ -102,6 +387,20 @@ interface ShadowChannelPolicy {
     mentionOnly: boolean;
     config: Record<string, unknown>;
 }
+interface ShadowSlashCommand {
+    name: string;
+    description?: string;
+    aliases?: string[];
+    packId?: string;
+    sourcePath?: string;
+    interaction?: ShadowInteractiveBlock;
+}
+interface ShadowChannelSlashCommand extends ShadowSlashCommand {
+    agentId: string;
+    botUserId: string;
+    botUsername: string;
+    botDisplayName?: string | null;
+}
 interface ShadowRemoteChannel {
     id: string;
     name: string;
@@ -119,12 +418,37 @@ interface ShadowRemoteServer {
 interface ShadowRemoteConfig {
     agentId: string;
     botUserId: string;
+    slashCommands?: ShadowSlashCommand[];
     servers: ShadowRemoteServer[];
 }
+interface ShadowUsageProviderSnapshot {
+    provider: string;
+    amountUsd?: number | null;
+    usageLabel?: string | null;
+    raw?: string | null;
+    inputTokens?: number | null;
+    outputTokens?: number | null;
+    totalTokens?: number | null;
+}
+interface ShadowAgentUsageSnapshotInput {
+    source?: string;
+    model?: string | null;
+    totalUsd?: number | null;
+    inputTokens?: number | null;
+    outputTokens?: number | null;
+    cacheReadTokens?: number | null;
+    cacheWriteTokens?: number | null;
+    totalTokens?: number | null;
+    providers?: ShadowUsageProviderSnapshot[];
+    raw?: Record<string, unknown>;
+    generatedAt?: string;
+}
 interface TypingPayload {
     channelId: string;
     userId: string;
     username: string;
+    displayName?: string | null;
+    typing?: boolean;
 }
 interface PresenceChangePayload {
     userId: string;
@@ -134,6 +458,8 @@ interface PresenceActivityPayload {
     userId: string;
     activity: string | null;
     channelId: string;
+    username?: string;
+    displayName?: string | null;
 }
 interface MemberJoinPayload {
     channelId: string;
@@ -143,6 +469,13 @@ interface MemberLeavePayload {
     channelId: string;
     userId: string;
 }
+interface SlashCommandsUpdatedPayload {
+    channelId: string;
+    serverId?: string;
+    agentId?: string;
+    botUserId?: string;
+    commandCount?: number;
+}
 interface ReactionPayload {
     messageId: string;
     userId: string;
@@ -160,11 +493,13 @@ interface ChannelCreatedPayload {
 }
 interface ChannelMemberAddedPayload {
     channelId: string;
-    userId: string;
+    serverId?: string;
+    userId?: string;
 }
 interface ChannelMemberRemovedPayload {
     channelId: string;
-    userId: string;
+    serverId?: string;
+    userId?: string;
 }
 interface ServerJoinedPayload {
     serverId: string;
@@ -175,23 +510,6 @@ interface PolicyChangedPayload {
     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;
@@ -253,11 +571,286 @@ interface ShadowContract {
 }
 interface ShadowShop {
     id: string;
-    serverId: string;
+    scopeKind?: 'server' | 'user';
+    serverId?: string | null;
+    ownerUserId?: string | null;
+    visibility?: string;
     name: string;
     description?: string | null;
     isEnabled: boolean;
 }
+type ShadowCommunityAssetType = 'badge' | 'gift' | 'coupon' | 'service_ticket' | 'collectible' | 'content_pass' | 'reward';
+interface ShadowCommunityAssetDefinition {
+    id: string;
+    issuerKind: 'platform' | 'server' | 'user' | 'shop';
+    issuerId?: string | null;
+    shopId?: string | null;
+    assetType: ShadowCommunityAssetType;
+    name: string;
+    description?: string | null;
+    imageUrl?: string | null;
+    giftable: boolean;
+    transferable: boolean;
+    consumable: boolean;
+    revocable: boolean;
+    expiresAfterDays?: number | null;
+    status: 'draft' | 'active' | 'paused' | 'archived';
+    metadata?: Record<string, unknown> | null;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface ShadowCommunityAssetGrant {
+    id: string;
+    definitionId: string;
+    ownerUserId: string;
+    sourceKind: string;
+    sourceId?: string | null;
+    quantity: number;
+    remainingQuantity: number;
+    status: 'active' | 'locked' | 'consumed' | 'revoked' | 'expired';
+    expiresAt?: string | null;
+    metadata?: Record<string, unknown> | null;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface ShadowCommunityAsset {
+    grant: ShadowCommunityAssetGrant;
+    definition: ShadowCommunityAssetDefinition;
+}
+interface ShadowEconomyTip {
+    id: string;
+    senderUserId: string;
+    recipientUserId: string;
+    amount: number;
+    sellerNet: number;
+    status: 'succeeded' | 'failed' | 'reversed' | 'held';
+    contextKind?: string | null;
+    contextId?: string | null;
+    message?: string | null;
+    createdAt?: string;
+}
+interface ShadowEconomyGift {
+    id: string;
+    senderUserId: string;
+    recipientUserId: string;
+    status: 'succeeded' | 'failed' | 'reversed' | 'held';
+    message?: string | null;
+    metadata?: Record<string, unknown> | null;
+    createdAt?: string;
+}
+interface ShadowSettlementLine {
+    id: string;
+    sellerUserId: string;
+    shopId?: string | null;
+    sourceType: 'order' | 'tip' | 'gift' | 'adjustment';
+    sourceId: string;
+    grossAmount: number;
+    platformFee: number;
+    netAmount: number;
+    status: 'pending' | 'available' | 'settled' | 'failed' | 'held' | 'reversed';
+    availableAt?: string | null;
+    settledAt?: string | null;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface ShadowCommerceProductCard {
+    id: string;
+    kind: 'offer' | 'product';
+    offerId?: string;
+    shopId: string;
+    shopScope: {
+        kind: 'server' | 'user';
+        id: string;
+    };
+    productId: string;
+    skuId?: string;
+    snapshot: {
+        name: string;
+        summary?: string | null;
+        imageUrl?: string | null;
+        price: number;
+        currency: string;
+        productType: 'physical' | 'entitlement';
+        billingMode?: 'one_time' | 'fixed_duration' | 'subscription';
+        durationSeconds?: number | null;
+        resourceType?: string;
+        resourceId?: string;
+        capability?: string;
+    };
+    purchase: {
+        mode: 'direct' | 'select_sku' | 'open_detail';
+    };
+}
+interface ShadowCommerceProductPickerGroup {
+    key: string;
+    labelKey: string;
+    shopId: string;
+    shopName: string;
+    shopScope: {
+        kind: 'server' | 'user';
+        id: string;
+    };
+    cards: ShadowCommerceProductCard[];
+}
+interface ShadowCommerceProductPickerResponse {
+    cards: ShadowCommerceProductCard[];
+    groups?: ShadowCommerceProductPickerGroup[];
+}
+interface ShadowEntitlementProvisioning {
+    status: 'provisioned' | 'manual_pending' | 'failed' | string;
+    code: string;
+    provisionedAt?: string;
+    checkedAt?: string;
+    resourceType?: string | null;
+    resourceId?: string | null;
+    capability?: string | null;
+}
+interface ShadowEntitlement {
+    id: string;
+    userId: string;
+    serverId?: string | null;
+    shopId?: string | null;
+    orderId?: string | null;
+    productId?: string | null;
+    offerId?: string | null;
+    scopeKind?: 'server' | 'user' | string;
+    resourceType: string;
+    resourceId: string;
+    capability: string;
+    status: string;
+    isActive: boolean;
+    startsAt?: string;
+    expiresAt?: string | null;
+    nextRenewalAt?: string | null;
+    cancelledAt?: string | null;
+    revokedAt?: string | null;
+    metadata?: Record<string, unknown> | null;
+    createdAt?: string;
+    updatedAt?: string;
+    shop?: {
+        id: string;
+        scopeKind: 'server' | 'user' | string;
+        serverId?: string | null;
+        ownerUserId?: string | null;
+        name: string;
+        logoUrl?: string | null;
+    } | null;
+    product?: {
+        id: string;
+        shopId: string;
+        name: string;
+        summary?: string | null;
+        type: 'physical' | 'entitlement' | string;
+        basePrice: number;
+        currency: string;
+        billingMode: 'one_time' | 'fixed_duration' | 'subscription' | string;
+        entitlementConfig?: Record<string, unknown> | Record<string, unknown>[] | null;
+    } | null;
+    offer?: {
+        id: string;
+        shopId: string;
+        productId: string;
+        priceOverride?: number | null;
+        currency: string;
+        status: string;
+    } | null;
+    paidFile?: {
+        id: string;
+        name: string;
+        mime?: string | null;
+        sizeBytes?: number | null;
+        previewUrl?: string | null;
+    } | null;
+}
+interface ShadowEntitlementPurchaseResult {
+    order: {
+        id: string;
+        orderNo: string;
+        status: string;
+        totalAmount: number;
+    };
+    entitlement: Record<string, unknown>;
+    provisioning?: ShadowEntitlementProvisioning;
+    fulfillmentJobs?: Record<string, unknown>[];
+    nextAction?: 'open_paid_file' | 'view_entitlement' | string;
+}
+interface ShadowCommerceCheckoutPreview {
+    offer: {
+        id: string;
+        status: string;
+        available: boolean;
+        allowedSurfaces?: string[] | null;
+    };
+    shop: {
+        id: string;
+        name: string;
+        scopeKind: 'server' | 'user' | string;
+        logoUrl?: string | null;
+    };
+    product: {
+        id: string;
+        name: string;
+        summary?: string | null;
+        imageUrl?: string | null;
+        type: 'physical' | 'entitlement' | string;
+        billingMode?: 'one_time' | 'fixed_duration' | 'subscription' | string;
+        price: number;
+        currency: string;
+        durationSeconds?: number | null;
+    };
+    entitlement?: {
+        resourceType: string;
+        resourceId: string;
+        capability: string;
+        access: {
+            allowed: boolean;
+            status: string;
+            reasonCode?: string | null;
+            entitlement?: Record<string, unknown> | null;
+        };
+    } | null;
+    paidFile?: {
+        id: string;
+        name: string;
+        mime?: string | null;
+        sizeBytes?: number | null;
+        previewUrl?: string | null;
+    } | null;
+    deliverables?: Record<string, unknown>[];
+    viewerState: 'not_purchased' | 'active' | 'expired' | 'revoked' | 'cancelled' | 'unavailable';
+    primaryAction?: 'purchase' | 'open_content' | 'renew' | 'view_detail' | 'view_progress' | 'unavailable' | string;
+    displayState?: {
+        viewerState: string;
+        primaryAction: string;
+        price: {
+            amount: number;
+            currency: string;
+        };
+        balance?: {
+            current: number;
+            afterPurchase?: number;
+            shortfall?: number;
+        } | null;
+        seller?: {
+            shopId: string;
+            shopName: string;
+            buddyUserId?: string | null;
+        };
+        entitlement?: Record<string, unknown> | null;
+        delivery?: Record<string, unknown> | null;
+        content?: Record<string, unknown> | null;
+    };
+    nextAction: 'purchase' | 'open_paid_file' | 'view_entitlement' | string;
+}
+interface ShadowPaidFileOpenResult {
+    grant: {
+        id: string;
+        fileId: string;
+        status: string;
+        expiresAt: string;
+    };
+    viewerUrl: string;
+}
 interface ShadowCategory {
     id: string;
     shopId: string;
@@ -275,6 +868,7 @@ interface ShadowProduct {
     currency: string;
     stock: number;
     status: string;
+    billingMode?: 'one_time' | 'fixed_duration' | 'subscription';
     images: string[];
     createdAt: string;
 }
@@ -293,6 +887,7 @@ interface ShadowOrder {
     currency: string;
     items: {
         productId: string;
+        skuId?: string | null;
         quantity: number;
         price: number;
     }[];
@@ -319,8 +914,345 @@ interface ShadowTransaction {
     walletId: string;
     type: string;
     amount: number;
+    balanceAfter?: number;
+    currency?: string;
+    referenceId?: string | null;
+    referenceType?: string | null;
+    note?: string | null;
     description?: string | null;
+    display?: {
+        title?: string | null;
+        subtitle?: string | null;
+    } | null;
+    order?: Record<string, unknown> | null;
+    counterparty?: Record<string, unknown> | null;
+    createdAt: string;
+}
+type ShadowDiyCloudStepId = 'think' | 'search' | 'generate' | 'validate' | 'review';
+interface ShadowDiyCloudGenerateInput {
+    prompt: string;
+    feedback?: string;
+    previousConfig?: Record<string, unknown>;
+    locale?: string;
+    timezone?: string;
+}
+interface ShadowDiyCloudAgentStepOutput {
+    type: 'agent_step_output';
+    schemaVersion: 1;
+    step: ShadowDiyCloudStepId;
+    status: ShadowDiyCloudProgressStatus;
+    title: string;
+    locale: string;
+    timezone: string;
+    generatedAt: string;
+    result: Record<string, unknown>;
+    reasons: string[];
+    confidence?: number;
+}
+interface ShadowDiyCloudDraft {
+    slug: string;
+    title: string;
+    description: string;
+    score: number;
+    steps: Array<{
+        id: ShadowDiyCloudStepId;
+        title: string;
+        detail: string;
+    }>;
+    matchedPlugins: Array<{
+        id: string;
+        name: string;
+        description: string;
+        reason: string;
+        capabilities: string[];
+        requiredKeys: string[];
+        matchedTerms: string[];
+    }>;
+    referenceTemplates: Array<{
+        slug: string;
+        title: string;
+        description: string;
+        category: string;
+        plugins: string[];
+        channels: string[];
+        buddyNames: string[];
+        reason: string;
+    }>;
+    suggestedSkills: string[];
+    requiredKeys: Array<{
+        key: string;
+        label: string;
+        description: string;
+        source: string;
+        sourcePluginId: string;
+        sensitive: boolean;
+        setupSteps: string[];
+        skipImpact: string;
+    }>;
+    toolTrace: Array<{
+        tool: 'search_plugins' | 'inspect_plugin' | 'search_templates' | 'inspect_template' | 'compile_template_dsl' | 'validate_template_dsl' | 'collect_required_keys';
+        query?: string;
+        resultIds: string[];
+    }>;
+    agentOutputs: ShadowDiyCloudAgentStepOutput[];
+    agentReport: {
+        objective: string;
+        assumptions: string[];
+        reasoning: Array<{
+            step: ShadowDiyCloudStepId;
+            title: string;
+            detail: string;
+            evidence: string[];
+        }>;
+        pluginDecisions: Array<{
+            id: string;
+            name: string;
+            reason: string;
+            capabilities: string[];
+            matchedTerms: string[];
+            requiredKeys: string[];
+        }>;
+        templateDecisions: Array<{
+            slug: string;
+            title: string;
+            reason: string;
+            plugins: string[];
+            channels: string[];
+        }>;
+        validationChecks: Array<{
+            name: string;
+            status: 'passed' | 'warning' | 'failed';
+            detail: string;
+        }>;
+        repairNotes: string[];
+    };
+    guidebook: {
+        summary: string;
+        beforeDeploy: string[];
+        howToUse: string[];
+        reviewNotes: string[];
+    };
+    template: Record<string, unknown>;
+    validation: {
+        valid: boolean;
+        agents: number;
+        configurations: number;
+        violations: Array<{
+            path: string;
+            prefix: string;
+        }>;
+        extendsErrors: string[];
+        templateRefs: {
+            env: number;
+            secret: number;
+            file: number;
+        };
+    };
+}
+type ShadowDiyCloudProgressStatus = 'running' | 'completed' | 'warning' | 'error';
+type ShadowDiyCloudRunStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+interface ShadowDiyCloudRun {
+    runId: string;
+    input: ShadowDiyCloudGenerateInput;
+    status: ShadowDiyCloudRunStatus;
     createdAt: string;
+    updatedAt: string;
+    expiresAt: string;
+    draft?: ShadowDiyCloudDraft;
+    error?: string;
+}
+type ShadowDiyCloudRunEvent = {
+    schemaVersion: 2;
+    seq: number;
+    runId: string;
+    eventId: string;
+    timestamp: string;
+    type: 'run.created' | 'run.started' | 'run.cancelled';
+    status?: ShadowDiyCloudRunStatus;
+    input?: ShadowDiyCloudGenerateInput;
+    expiresAt?: string;
+} | {
+    schemaVersion: 2;
+    seq: number;
+    runId: string;
+    eventId: string;
+    timestamp: string;
+    type: 'step.created';
+    stepId: ShadowDiyCloudStepId;
+    title: string;
+    intent: string;
+    order: number;
+    iconHint?: string;
+} | {
+    schemaVersion: 2;
+    seq: number;
+    runId: string;
+    eventId: string;
+    timestamp: string;
+    type: 'step.delta';
+    stepId: ShadowDiyCloudStepId;
+    channel: 'summary' | 'rationale' | 'status';
+    delta: string;
+    status?: ShadowDiyCloudProgressStatus;
+    title?: string;
+    meta?: Record<string, unknown>;
+} | {
+    schemaVersion: 2;
+    seq: number;
+    runId: string;
+    eventId: string;
+    timestamp: string;
+    type: 'decision';
+    stepId: ShadowDiyCloudStepId;
+    decisionId: string;
+    title: string;
+    selected: string;
+    basis: {
+        observations: string[];
+        constraints: string[];
+        evidence: Array<{
+            source: string;
+            ref: string;
+            summary: string;
+        }>;
+        rejectedOptions: Array<{
+            option: string;
+            reason: string;
+        }>;
+        confidence?: number | null;
+        needsUserReview: boolean;
+    };
+    output?: ShadowDiyCloudAgentStepOutput;
+} | {
+    schemaVersion: 2;
+    seq: number;
+    runId: string;
+    eventId: string;
+    timestamp: string;
+    type: 'artifact.patch';
+    stepId: ShadowDiyCloudStepId;
+    artifact: 'templateDsl' | 'cloudConfig' | 'guidebook' | 'requiredKeys';
+    patch: unknown;
+} | {
+    schemaVersion: 2;
+    seq: number;
+    runId: string;
+    eventId: string;
+    timestamp: string;
+    type: 'guardrail.result';
+    stepId: ShadowDiyCloudStepId;
+    name: string;
+    status: 'passed' | 'warning' | 'failed' | 'error';
+    detail: string;
+    blocksRun: boolean;
+} | {
+    schemaVersion: 2;
+    seq: number;
+    runId: string;
+    eventId: string;
+    timestamp: string;
+    type: 'draft.completed';
+    draft: ShadowDiyCloudDraft;
+} | {
+    schemaVersion: 2;
+    seq: number;
+    runId: string;
+    eventId: string;
+    timestamp: string;
+    type: 'run.failed';
+    error: string;
+    code?: string;
+    retryable: boolean;
+};
+type ShadowCloudDeploymentStatus = 'pending' | 'deploying' | 'cancelling' | 'deployed' | 'paused' | 'resuming' | 'failed' | 'destroying' | 'destroyed';
+interface ShadowCloudDeploymentRuntimeResponse {
+    ok: boolean;
+    status: ShadowCloudDeploymentStatus;
+    deployment?: Record<string, unknown>;
+}
+interface ShadowCloudDeploymentManifest {
+    deploymentId: string;
+    namespace: string;
+    name: string;
+    templateSlug: string | null;
+    template: Record<string, unknown> | null;
+    manifest: Record<string, unknown> | null;
+    drift: {
+        status: 'up-to-date' | 'template-updated' | 'missing-template' | 'unlinked' | 'unknown';
+        templateAvailable: boolean;
+        templateChanged: boolean;
+        deployedTemplateHash: string | null;
+        currentTemplateHash: string | null;
+        configHash: string | null;
+    };
+    configSnapshot: Record<string, unknown> | null;
+}
+interface ShadowCloudDeploymentTemplateSyncResult {
+    ok: boolean;
+    action: 'updated' | 'forked';
+    template: Record<string, unknown>;
+    manifest: ShadowCloudDeploymentManifest;
+}
+interface ShadowCloudDeploymentBackup {
+    id: string;
+    deploymentId: string;
+    namespace: string;
+    agentId: string;
+    sandboxName: string | null;
+    pvcName: string;
+    driver: 'volumeSnapshot' | 'restic' | string;
+    snapshotName: string | null;
+    objectKey: string | null;
+    status: 'pending' | 'running' | 'succeeded' | 'failed' | 'expired' | string;
+    phase: string;
+    error: string | null;
+    expiresAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ShadowCloudProviderCatalog {
+    pluginId: string;
+    pluginName: string;
+    provider: Record<string, unknown>;
+    secretFields?: Record<string, unknown>[];
+}
+interface ShadowCloudProviderEnvVar {
+    key: string;
+    maskedValue: string;
+    isSecret: boolean;
+}
+interface ShadowCloudProviderModel {
+    id: string;
+    name?: string;
+    tags?: string[];
+    contextWindow?: number;
+    maxTokens?: number;
+    cost?: {
+        input?: number;
+        output?: number;
+    };
+    capabilities?: {
+        vision?: boolean;
+        tools?: boolean;
+        reasoning?: boolean;
+    };
+}
+interface ShadowCloudProviderProfile {
+    id: string;
+    providerId: string;
+    name: string;
+    scope: string;
+    enabled: boolean;
+    config: {
+        baseUrl?: string;
+        apiFormat?: 'openai' | 'anthropic' | 'gemini';
+        authType?: 'api_key';
+        discoveredAt?: string;
+        models?: ShadowCloudProviderModel[];
+        [key: string]: unknown;
+    };
+    envVars: ShadowCloudProviderEnvVar[];
+    updatedAt?: string;
 }
 interface ShadowTask {
     key: string;
@@ -330,15 +1262,44 @@ interface ShadowTask {
     status: string;
     claimedAt?: string | null;
 }
-interface ShadowApp {
+interface ShadowRechargeTier {
+    key: string;
+    shrimpCoins: number;
+    usdCents: number;
+    label: string;
+}
+interface ShadowRechargeConfig {
+    tiers: ShadowRechargeTier[];
+    customAmountMin: number;
+    customAmountMax: number;
+    exchangeRate: number;
+    stripePublishableKey: string;
+}
+interface ShadowRechargeIntent {
+    clientSecret: string;
+    paymentIntentId: string;
+    orderNo: string;
+    amount: {
+        shrimpCoins: number;
+        usdCents: number;
+    };
+}
+interface ShadowPaymentOrder {
     id: string;
-    serverId: string;
-    name: string;
-    slug: string;
-    type: string;
-    url?: string | null;
+    orderNo: string;
+    shrimpCoinAmount: number;
+    usdAmount: number;
     status: string;
+    localCurrencyAmount?: number | null;
+    localCurrency?: string | null;
     createdAt: string;
+    paidAt?: string | null;
+}
+interface ShadowRechargeHistory {
+    items: ShadowPaymentOrder[];
+    total: number;
+    limit: number;
+    offset: number;
 }
 interface ShadowNotificationPreferences {
     strategy: 'all' | 'mention_only' | 'none';
@@ -350,18 +1311,23 @@ interface ServerEventMap {
     'message:new': (message: ShadowMessage) => void;
     'message:updated': (message: ShadowMessage) => void;
     'message:deleted': (payload: MessageDeletedPayload) => void;
+    'message:typing': (payload: TypingPayload) => void;
     'member:typing': (payload: TypingPayload) => void;
     'member:join': (payload: MemberJoinPayload) => void;
+    'member:joined': (payload: MemberJoinPayload & {
+        isBot?: boolean;
+    }) => void;
     'member:leave': (payload: MemberLeavePayload) => void;
+    'member:left': (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;
+    'channel:slash-commands-updated': (payload: SlashCommandsUpdatedPayload) => void;
     'server:joined': (payload: ServerJoinedPayload) => void;
     'agent:policy-changed': (payload: PolicyChangedPayload) => void;
     error: (payload: {
@@ -383,9 +1349,12 @@ interface ClientEventMap {
         content: string;
         threadId?: string;
         replyToId?: string;
+        mentions?: ShadowMessageMention[];
+        metadata?: Record<string, unknown>;
     }) => void;
     'message:typing': (data: {
         channelId: string;
+        typing?: boolean;
     }) => void;
     'presence:update': (data: {
         status: 'online' | 'idle' | 'dnd' | 'offline';
@@ -405,27 +1374,36 @@ declare class ShadowClient {
     private token;
     private baseUrl;
     constructor(baseUrl: string, token: string);
+    private isShadowPrivateMediaUrl;
     private request;
     private requestRaw;
     register(data: {
         email: string;
         password: string;
-        username: string;
+        username?: string;
         displayName?: string;
-        inviteCode: string;
-    }): Promise<{
-        token: string;
-        user: ShadowUser;
-    }>;
+        inviteCode?: string;
+    }): Promise<ShadowAuthResponse>;
     login(data: {
         email: string;
         password: string;
+    }): Promise<ShadowAuthResponse>;
+    startEmailLogin(data: {
+        email: string;
+        locale?: string;
     }): Promise<{
-        token: string;
-        user: ShadowUser;
+        ok: true;
+        expiresIn: number;
+        devCode?: string;
     }>;
-    refreshToken(): Promise<{
-        token: string;
+    verifyEmailLogin(data: {
+        email: string;
+        code: string;
+        displayName?: string;
+    }): Promise<ShadowAuthResponse>;
+    refreshToken(refreshToken: string): Promise<{
+        accessToken: string;
+        refreshToken: string;
     }>;
     getMe(): Promise<ShadowUser>;
     updateProfile(data: {
@@ -435,6 +1413,19 @@ declare class ShadowClient {
     disconnect(): Promise<{
         success: boolean;
     }>;
+    getMembership(): Promise<ShadowMembership>;
+    redeemInviteCode(code: string): Promise<ShadowMembership>;
+    launchPlay(data: {
+        playId?: string;
+        launchSessionId?: string;
+        inviteCode?: string;
+        locale?: string;
+    }): Promise<ShadowPlayLaunchResult>;
+    getPlayCatalog(): Promise<ShadowHomePlayCatalogItem[]>;
+    listOfficialModelProxyModels(): Promise<ShadowModelProxyModelsResponse>;
+    getOfficialModelProxyBilling(): Promise<ShadowModelProxyBilling>;
+    createOfficialChatCompletion(data: ShadowModelProxyChatCompletionRequest): Promise<ShadowModelProxyChatCompletionResponse>;
+    createOfficialChatCompletionStream(data: ShadowModelProxyChatCompletionRequest): Promise<Response>;
     listAgents(): Promise<{
         id: string;
         name: string;
@@ -442,8 +1433,12 @@ declare class ShadowClient {
     }[]>;
     createAgent(data: {
         name: string;
+        username: string;
+        description?: string;
         displayName?: string;
         avatarUrl?: string | null;
+        kernelType?: string;
+        config?: Record<string, unknown>;
     }): Promise<{
         id: string;
         token: string;
@@ -478,9 +1473,25 @@ declare class ShadowClient {
     sendHeartbeat(agentId: string): Promise<{
         ok: boolean;
     }>;
+    reportAgentUsageSnapshot(agentId: string, snapshot: ShadowAgentUsageSnapshotInput): Promise<{
+        ok: boolean;
+    }>;
     getAgentConfig(agentId: string): Promise<ShadowRemoteConfig>;
-    listPolicies(agentId: string, serverId: string): Promise<{
+    updateAgentSlashCommands(agentId: string, commands: ShadowSlashCommand[]): Promise<{
+        ok: boolean;
+        commands: ShadowSlashCommand[];
+    }>;
+    getAgentSlashCommands(agentId: string): Promise<{
+        commands: ShadowSlashCommand[];
+    }>;
+    listChannelSlashCommands(channelId: string): Promise<{
+        commands: ShadowChannelSlashCommand[];
+    }>;
+    listPolicies(agentId: string, serverId?: string): Promise<{
+        id: string;
+        serverId: string;
         channelId: string | null;
+        listen?: boolean;
         mentionOnly: boolean;
         reply: boolean;
         config: Record<string, unknown>;
@@ -491,9 +1502,13 @@ declare class ShadowClient {
         reply?: boolean;
         config?: Record<string, unknown>;
     }): Promise<{
+        id: string;
+        serverId: string;
         channelId: string | null;
+        listen?: boolean;
         mentionOnly: boolean;
         reply: boolean;
+        config?: Record<string, unknown>;
     }>;
     deletePolicy(agentId: string, serverId: string, channelId: string): Promise<{
         success: boolean;
@@ -508,6 +1523,7 @@ declare class ShadowClient {
     }): Promise<ShadowServer>;
     listServers(): Promise<ShadowServer[]>;
     getServer(serverIdOrSlug: string): Promise<ShadowServer>;
+    getServerAccess(serverIdOrSlug: string): Promise<ShadowServerAccess>;
     updateServer(serverIdOrSlug: string, data: {
         name?: string;
         description?: string | null;
@@ -522,6 +1538,10 @@ declare class ShadowClient {
     joinServer(serverId: string, inviteCode?: string): Promise<{
         success: boolean;
     }>;
+    requestServerAccess(serverIdOrSlug: string): Promise<ShadowServerJoinRequestResult>;
+    reviewServerJoinRequest(requestId: string, status: Exclude<ShadowServerJoinRequestStatus, 'pending'>): Promise<{
+        ok: boolean;
+    }>;
     leaveServer(serverId: string): Promise<{
         success: boolean;
     }>;
@@ -535,16 +1555,16 @@ declare class ShadowClient {
     regenerateInviteCode(serverId: string): Promise<{
         inviteCode: string;
     }>;
-    addAgentsToServer(serverId: string, agentIds: string[]): Promise<{
-        added: string[];
-    }>;
+    addAgentsToServer(serverId: string, agentIds: string[]): Promise<ShadowAddAgentsToServerResult>;
     getServerChannels(serverId: string): Promise<ShadowChannel[]>;
     createChannel(serverId: string, data: {
         name: string;
         type?: string;
         description?: string;
+        isPrivate?: boolean;
     }): Promise<ShadowChannel>;
     getChannel(channelId: string): Promise<ShadowChannel>;
+    getChannelAccess(channelId: string): Promise<ShadowChannelAccess>;
     getChannelMembers(channelId: string): Promise<ShadowMember[]>;
     updateChannel(channelId: string, data: {
         name?: string;
@@ -559,37 +1579,62 @@ declare class ShadowClient {
     addChannelMember(channelId: string, userId: string): Promise<{
         success: boolean;
     }>;
+    requestChannelAccess(channelId: string): Promise<ShadowChannelJoinRequestResult>;
+    reviewChannelJoinRequest(requestId: string, status: Exclude<ShadowChannelJoinRequestStatus, 'pending'>): Promise<{
+        ok: boolean;
+    }>;
     removeChannelMember(channelId: string, userId: string): Promise<{
         success: boolean;
     }>;
-    setBuddyPolicy(channelId: string, data: {
-        buddyUserId: string;
+    setBuddyPolicy(channelId: string, agentId: string, data: {
         mentionOnly?: boolean;
         reply?: boolean;
+        mode?: string;
+        config?: Record<string, unknown>;
     }): Promise<{
         success: boolean;
     }>;
-    getBuddyPolicy(channelId: string): Promise<{
-        buddyUserId: string | null;
-        mentionOnly: boolean;
-        reply: boolean;
-    } | null>;
+    getBuddyPolicy(channelId: string, agentId: string): Promise<Record<string, unknown> | null>;
     sendMessage(channelId: string, content: string, opts?: {
         threadId?: string;
         replyToId?: string;
+        mentions?: ShadowMessageMention[];
         metadata?: Record<string, unknown>;
+        attachments?: {
+            filename: string;
+            url: string;
+            contentType: string;
+            size: number;
+        }[];
     }): Promise<ShadowMessage>;
+    suggestMentions(input: {
+        channelId: string;
+        trigger: ShadowMentionSuggestionTrigger;
+        query?: string;
+        limit?: number;
+    }): Promise<{
+        suggestions: ShadowMentionSuggestion[];
+    }>;
+    resolveMentions(input: {
+        channelId: string;
+        content: string;
+        mentions?: ShadowMessageMention[];
+    }): Promise<{
+        mentions: ShadowMessageMention[];
+    }>;
     getMessages(channelId: string, limit?: number, cursor?: string): Promise<{
         messages: ShadowMessage[];
         hasMore: boolean;
     }>;
     getMessage(messageId: string): Promise<ShadowMessage>;
+    submitInteractiveAction(messageId: string, input: ShadowInteractiveActionInput): Promise<ShadowInteractiveActionResult>;
+    getInteractiveState(messageId: string, blockId?: string): Promise<ShadowInteractiveState>;
     editMessage(messageId: string, content: string): Promise<ShadowMessage>;
     deleteMessage(messageId: string): Promise<void>;
-    pinMessage(messageId: string, channelId?: string): Promise<{
+    pinMessage(messageId: string, channelId: string): Promise<{
         success: boolean;
     }>;
-    unpinMessage(messageId: string, channelId?: string): Promise<{
+    unpinMessage(messageId: string, channelId: string): Promise<{
         success: boolean;
     }>;
     getPinnedMessages(channelId: string): Promise<ShadowMessage[]>;
@@ -613,20 +1658,17 @@ declare class ShadowClient {
         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?: {
+    sendToThread(threadId: string, content: string, options?: {
         replyToId?: string;
         metadata?: Record<string, unknown>;
+        mentions?: ShadowMessageMention[];
     }): Promise<ShadowMessage>;
+    createDirectChannel(userId: string): Promise<ShadowChannel>;
+    listDirectChannels(): Promise<ShadowChannel[]>;
     listNotifications(limit?: number, offset?: number): Promise<ShadowNotification[]>;
-    markNotificationRead(notificationId: string): Promise<{
-        success: boolean;
-    }>;
+    markNotificationRead(notificationId: string): Promise<ShadowNotification>;
     markAllNotificationsRead(): Promise<{
-        success: boolean;
+        ok: boolean;
     }>;
     getUnreadCount(): Promise<{
         count: number;
@@ -648,16 +1690,23 @@ declare class ShadowClient {
     deleteInvite(inviteId: string): Promise<{
         success: boolean;
     }>;
-    uploadMedia(file: Blob | ArrayBuffer, filename: string, contentType: string, messageId?: string): Promise<{
+    uploadMedia(file: Blob | ArrayBuffer, filename: string, contentType: string, messageId?: string | {
+        messageId?: string;
+    }): Promise<{
         url: string;
         key: string;
         size: number;
     }>;
+    resolveAttachmentMediaUrl(attachmentId: string, options?: {
+        disposition?: 'inline' | 'attachment';
+    }): Promise<ShadowSignedMediaUrl>;
     /**
      * 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<{
+    uploadMediaFromUrl(mediaUrl: string, messageId?: string | {
+        messageId?: string;
+    }): Promise<{
         url: string;
         key: string;
         size: number;
@@ -744,6 +1793,14 @@ declare class ShadowClient {
     unlinkOAuthAccount(accountId: string): Promise<{
         success: boolean;
     }>;
+    changePassword(data: {
+        currentPassword: string;
+        newPassword: string;
+    }): Promise<{
+        ok: boolean;
+    }>;
+    getDashboard(): Promise<Record<string, unknown>>;
+    loginWithGoogleIdToken(idToken: string): Promise<ShadowAuthResponse>;
     sendFriendRequest(username: string): Promise<ShadowFriendship>;
     acceptFriendRequest(requestId: string): Promise<ShadowFriendship>;
     rejectFriendRequest(requestId: string): Promise<ShadowFriendship>;
@@ -757,11 +1814,30 @@ declare class ShadowClient {
         serverId?: string;
         channelId?: string;
     }): Promise<{
-        success: boolean;
+        updated: number;
     }>;
-    getScopedUnread(): Promise<Record<string, number>>;
+    getScopedUnread(): Promise<ShadowScopedUnread>;
     getNotificationPreferences(): Promise<ShadowNotificationPreferences>;
     updateNotificationPreferences(data: Partial<ShadowNotificationPreferences>): Promise<ShadowNotificationPreferences>;
+    getNotificationChannelPreferences(): Promise<Record<string, unknown>[]>;
+    updateNotificationChannelPreference(data: {
+        kind: string;
+        channel: string;
+        enabled: boolean;
+    }): Promise<Record<string, unknown>>;
+    registerPushToken(data: {
+        platform: 'ios' | 'android' | 'web' | string;
+        token: string;
+        deviceName?: string | null;
+    }): Promise<Record<string, unknown>>;
+    registerWebPushSubscription(data: {
+        endpoint: string;
+        keys: {
+            p256dh: string;
+            auth: string;
+        };
+        userAgent?: string | null;
+    }): Promise<Record<string, unknown>>;
     createOAuthApp(data: {
         name: string;
         redirectUris: string[];
@@ -864,6 +1940,85 @@ declare class ShadowClient {
         success: boolean;
     }>;
     getShop(serverId: string): Promise<ShadowShop>;
+    getMyShop(): Promise<ShadowShop>;
+    upsertMyShop(data: Partial<ShadowShop>): Promise<ShadowShop>;
+    getUserShop(userId: string): Promise<ShadowShop>;
+    getManagedUserShop(userId: string): Promise<ShadowShop>;
+    upsertManagedUserShop(userId: string, data: Partial<ShadowShop>): Promise<ShadowShop>;
+    getShopById(shopId: string): Promise<ShadowShop>;
+    listShopProducts(shopId: string, params?: {
+        keyword?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        products: ShadowProduct[];
+    }>;
+    getScopeNeutralProduct(productId: string): Promise<ShadowProduct>;
+    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>;
+    deleteShopProduct(shopId: string, productId: string): Promise<{
+        ok: boolean;
+    }>;
+    purchaseShopProduct(shopId: string, productId: string, data: {
+        idempotencyKey: string;
+        skuId?: string;
+    }): Promise<ShadowEntitlementPurchaseResult>;
+    purchaseCommerceOffer(offerId: string, data: {
+        idempotencyKey: string;
+        skuId?: string;
+        destinationKind?: 'channel' | 'dm';
+        destinationId?: string;
+    }): Promise<ShadowEntitlementPurchaseResult>;
+    getCommerceOfferCheckoutPreview(offerId: string, params?: {
+        skuId?: string;
+        viewerUserId?: string;
+    }): Promise<ShadowCommerceCheckoutPreview>;
+    createCommerceOffer(shopId: string, data: {
+        productId: string;
+        allowedSurfaces?: Array<'channel' | 'dm'>;
+        priceOverride?: number | null;
+        sellerBuddyUserId?: string | null;
+        status?: 'draft' | 'active' | 'paused' | 'archived';
+        metadata?: Record<string, unknown>;
+    }): Promise<Record<string, unknown>>;
+    listCommerceOffers(shopId: string, params?: {
+        keyword?: string;
+        limit?: number;
+    }): Promise<{
+        offers: Record<string, unknown>[];
+    }>;
+    createCommerceDeliverable(shopId: string, offerId: string, data: {
+        kind?: 'paid_file' | 'message' | 'external' | 'entitlement' | 'community_asset' | 'currency';
+        resourceType?: string;
+        resourceId: string;
+        senderBuddyUserId?: string | null;
+        messageTemplateKey?: string | null;
+        metadata?: Record<string, unknown>;
+    }): Promise<Record<string, unknown>>;
+    listShopAssetDefinitions(shopId: string): Promise<{
+        assets: ShadowCommunityAssetDefinition[];
+    }>;
+    createShopAssetDefinition(shopId: string, data: Partial<ShadowCommunityAssetDefinition> & {
+        assetType: ShadowCommunityAssetDefinition['assetType'];
+        name: string;
+    }): Promise<ShadowCommunityAssetDefinition>;
+    updateShopAssetDefinition(shopId: string, assetDefinitionId: string, data: Partial<Omit<ShadowCommunityAssetDefinition, 'id' | 'assetType'>>): Promise<ShadowCommunityAssetDefinition>;
+    purchaseMessageCommerceCard(messageId: string, cardId: string, data: {
+        idempotencyKey: string;
+        skuId?: string;
+    }): Promise<ShadowEntitlementPurchaseResult>;
+    listCommerceProductCards(params: {
+        target: 'channel';
+        channelId: string;
+        keyword?: string;
+        limit?: number;
+    }): Promise<ShadowCommerceProductPickerResponse>;
+    openPaidFile(fileId: string): Promise<ShadowPaidFileOpenResult>;
+    listShopEntitlements(shopId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
     updateShop(serverId: string, data: Partial<{
         name: string;
         description: string | null;
@@ -923,9 +2078,11 @@ declare class ShadowClient {
     removeCartItem(serverId: string, itemId: string): Promise<{
         success: boolean;
     }>;
-    createOrder(serverId: string, data?: {
+    createOrder(serverId: string, data: {
+        idempotencyKey: string;
         items?: {
             productId: string;
+            skuId?: string;
             quantity: number;
         }[];
     }): Promise<ShadowOrder>;
@@ -942,9 +2099,207 @@ declare class ShadowClient {
     }): 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>[]>;
+    topUpWallet(_amount: number): Promise<ShadowWallet>;
+    getWalletTransactions(params?: {
+        audience?: 'ledger' | 'consumer';
+        direction?: 'all' | 'income' | 'expense';
+        limit?: number;
+        offset?: number;
+    }): Promise<ShadowTransaction[]>;
+    listCommunityAssets(): Promise<{
+        assets: ShadowCommunityAsset[];
+    }>;
+    getCommunityAsset(grantId: string): Promise<ShadowCommunityAsset>;
+    consumeCommunityAsset(grantId: string, data: {
+        idempotencyKey: string;
+    }): Promise<{
+        grant: ShadowCommunityAssetGrant;
+    }>;
+    lockCommunityAsset(grantId: string, data: {
+        idempotencyKey: string;
+    }): Promise<{
+        grant: ShadowCommunityAssetGrant;
+    }>;
+    unlockCommunityAsset(grantId: string, data: {
+        idempotencyKey: string;
+    }): Promise<{
+        grant: ShadowCommunityAssetGrant;
+    }>;
+    revokeCommunityAsset(grantId: string, data: {
+        idempotencyKey: string;
+        reason?: string;
+    }): Promise<{
+        grant: ShadowCommunityAssetGrant;
+    }>;
+    sendTip(data: {
+        recipientUserId: string;
+        amount: number;
+        message?: string;
+        context?: {
+            kind: string;
+            id: string;
+        };
+        idempotencyKey: string;
+    }): Promise<{
+        tip: ShadowEconomyTip;
+    }>;
+    listTips(): Promise<{
+        tips: ShadowEconomyTip[];
+    }>;
+    sendGift(data: {
+        recipientUserId: string;
+        assets?: Array<{
+            assetGrantId: string;
+            quantity?: number;
+        }>;
+        currencies?: Array<{
+            currencyCode: 'shrimp_coin';
+            amount: number;
+        }>;
+        message?: string;
+        idempotencyKey: string;
+    }): Promise<{
+        gift: ShadowEconomyGift;
+    }>;
+    listGifts(): Promise<{
+        gifts: ShadowEconomyGift[];
+    }>;
+    listSettlements(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        settlements: ShadowSettlementLine[];
+    }>;
+    settleAvailableSettlements(): Promise<{
+        settlements: ShadowSettlementLine[];
+    }>;
+    createDiyCloudRun(data: ShadowDiyCloudGenerateInput): Promise<{
+        runId: string;
+        status: ShadowDiyCloudRunStatus;
+        createdAt: string;
+        expiresAt: string;
+        streamUrl: string;
+    }>;
+    getDiyCloudRun(runId: string): Promise<{
+        run: ShadowDiyCloudRun;
+        events: ShadowDiyCloudRunEvent[];
+    }>;
+    createDiyCloudFeedbackRun(runId: string, data: {
+        feedback: string;
+        prompt?: string;
+        locale?: string;
+        timezone?: string;
+    }): Promise<{
+        runId: string;
+        sourceRunId: string;
+        status: ShadowDiyCloudRunStatus;
+        createdAt: string;
+        expiresAt: string;
+        streamUrl: string;
+    }>;
+    streamDiyCloudRun(runId: string, options?: {
+        afterSeq?: number;
+    }): Promise<Response>;
+    cancelDiyCloudRun(runId: string): Promise<{
+        ok: boolean;
+        status: ShadowDiyCloudRunStatus;
+    }>;
+    getCloudDeploymentManifest(deploymentId: string): Promise<ShadowCloudDeploymentManifest>;
+    syncCloudDeploymentTemplate(deploymentId: string, data?: {
+        name?: string;
+        description?: string;
+        content?: Record<string, unknown>;
+        tags?: string[];
+        category?: string;
+        baseCost?: number;
+    }): Promise<ShadowCloudDeploymentTemplateSyncResult>;
+    redeployCloudDeployment(deploymentId: string, data?: {
+        mode?: 'snapshot' | 'template';
+        templateSlug?: string;
+        configSnapshot?: Record<string, unknown>;
+        envVars?: Record<string, string>;
+        runtimeContext?: {
+            locale?: string;
+            timezone?: string;
+        };
+    }): Promise<Record<string, unknown>>;
+    pauseCloudDeployment(deploymentId: string, data?: {
+        agentId?: string;
+    }): Promise<ShadowCloudDeploymentRuntimeResponse>;
+    resumeCloudDeployment(deploymentId: string, data?: {
+        agentId?: string;
+    }): Promise<ShadowCloudDeploymentRuntimeResponse>;
+    listCloudDeploymentBackups(deploymentId: string, params?: {
+        agentId?: string;
+    }): Promise<{
+        deploymentId: string;
+        backups: ShadowCloudDeploymentBackup[];
+    }>;
+    createCloudDeploymentBackup(deploymentId: string, data?: {
+        agentId?: string;
+        driver?: 'volumeSnapshot' | 'restic';
+        retentionDays?: number;
+    }): Promise<{
+        ok: boolean;
+        backup: ShadowCloudDeploymentBackup;
+    }>;
+    restoreCloudDeploymentBackup(deploymentId: string, data?: {
+        agentId?: string;
+        backupId?: string;
+    }): Promise<ShadowCloudDeploymentRuntimeResponse & {
+        backup: ShadowCloudDeploymentBackup;
+    }>;
+    listCloudProviderCatalogs(): Promise<{
+        providers: ShadowCloudProviderCatalog[];
+    }>;
+    listCloudProviderProfiles(): Promise<{
+        profiles: ShadowCloudProviderProfile[];
+    }>;
+    upsertCloudProviderProfile(data: {
+        id?: string;
+        providerId: string;
+        name: string;
+        enabled?: boolean;
+        config?: Record<string, unknown>;
+        envVars?: Record<string, string>;
+    }): Promise<{
+        ok: boolean;
+        success?: boolean;
+        profile?: ShadowCloudProviderProfile;
+    }>;
+    testCloudProviderProfile(profileId: string): Promise<Record<string, unknown>>;
+    refreshCloudProviderProfileModels(profileId: string): Promise<{
+        ok: boolean;
+        success?: boolean;
+        status?: number | null;
+        message?: string;
+        models?: ShadowCloudProviderModel[];
+        profile?: ShadowCloudProviderProfile;
+    }>;
+    deleteCloudProviderProfile(profileId: string): Promise<{
+        ok: boolean;
+        success?: boolean;
+    }>;
+    getRechargeConfig(): Promise<ShadowRechargeConfig>;
+    createRechargeIntent(params: {
+        tier: '1000' | '3000' | '5000' | 'custom';
+        idempotencyKey: string;
+        customAmount?: number;
+        currency?: string;
+    }): Promise<ShadowRechargeIntent>;
+    getRechargeHistory(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<ShadowRechargeHistory>;
+    confirmRechargePayment(paymentIntentId: string): Promise<ShadowPaymentOrder>;
+    getEntitlements(serverId: string): Promise<ShadowEntitlement[]>;
+    getAllEntitlements(): Promise<ShadowEntitlement[]>;
+    verifyEntitlement(entitlementId: string): Promise<{
+        active: boolean;
+        entitlement: Record<string, unknown>;
+        provisioning: ShadowEntitlementProvisioning;
+    }>;
+    cancelEntitlement(entitlementId: string, reason?: string): Promise<Record<string, unknown>>;
     getTaskCenter(): Promise<{
         tasks: ShadowTask[];
     }>;
@@ -963,36 +2318,111 @@ declare class ShadowClient {
             createdAt: string;
         }[];
     }>;
-    listApps(serverId: string, params?: {
-        status?: string;
+    createApiToken(data: {
+        name: string;
+        scope?: string;
+        expiresInDays?: number;
+    }): Promise<{
+        id: string;
+        name: string;
+        token: string;
+        scope?: string;
+        expiresAt?: string | null;
+        createdAt: string;
+    }>;
+    listApiTokens(): Promise<{
+        id: string;
+        name: string;
+        scope?: string;
+        expiresAt?: string | null;
+        createdAt: string;
+    }[]>;
+    deleteApiToken(tokenId: string): Promise<{
+        ok: boolean;
+    }>;
+    discoverFeed(params?: {
+        type?: 'all' | 'servers' | 'channels' | 'rentals';
         limit?: number;
         offset?: number;
     }): Promise<{
-        apps: ShadowApp[];
+        items: Record<string, unknown>[];
         total: number;
+        hasMore: boolean;
     }>;
-    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;
+    discoverSearch(params: {
+        q: string;
+        type?: 'all' | 'servers' | 'channels' | 'rentals';
+        limit?: number;
+    }): Promise<{
+        items: Record<string, unknown>[];
+        total: number;
     }>;
-    publishApp(serverId: string, data: {
-        name: string;
-        slug: string;
-    }): Promise<ShadowApp>;
+    enhanceVoice(data: {
+        transcript: string;
+        language?: string;
+        options?: {
+            enableSelfCorrection?: boolean;
+            enableListFormatting?: boolean;
+            enableFillerRemoval?: boolean;
+            enableToneAdjustment?: boolean;
+            targetTone?: 'formal' | 'casual' | 'professional';
+        };
+    }): Promise<Record<string, unknown>>;
+    enhanceVoiceQuery(params: {
+        transcript: string;
+        language?: string;
+        enableSelfCorrection?: boolean;
+        enableListFormatting?: boolean;
+        enableFillerRemoval?: boolean;
+        enableToneAdjustment?: boolean;
+        targetTone?: 'formal' | 'casual' | 'professional';
+    }): Promise<Record<string, unknown>>;
+    getVoiceConfig(): Promise<Record<string, unknown>>;
+    updateVoiceConfig(data: {
+        provider: 'openai' | 'anthropic' | 'alibaba' | 'custom';
+        apiKey: string;
+        baseUrl?: string;
+        model?: string;
+        temperature?: number;
+        maxTokens?: number;
+        timeout?: number;
+        enabled?: boolean;
+    }): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+    voiceHealthCheck(): Promise<Record<string, unknown>>;
+    getProfileComments(profileUserId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
+    getProfileCommentStats(profileUserId: string): Promise<Record<string, unknown>>;
+    getCommentReplies(parentId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
+    createProfileComment(data: {
+        profileUserId: string;
+        content: string;
+        parentId?: string;
+    }): Promise<Record<string, unknown>>;
+    deleteProfileComment(commentId: string): Promise<{
+        ok: boolean;
+    }>;
+    addProfileCommentReaction(commentId: string, emoji: string): Promise<Record<string, unknown>>;
+    removeProfileCommentReaction(commentId: string, emoji: string): Promise<{
+        ok: boolean;
+    }>;
+    getAgentDashboard(agentId: string): Promise<Record<string, unknown>>;
+    addAgentDashboardEvent(agentId: string, data: {
+        eventType: string;
+        eventData?: Record<string, unknown>;
+    }): Promise<{
+        ok: boolean;
+    }>;
+    archiveChannel(channelId: string, reason?: string): Promise<Record<string, unknown>>;
+    unarchiveChannel(channelId: string): Promise<Record<string, unknown>>;
+    getArchivedChannels(serverId: string): Promise<Record<string, unknown>[]>;
 }
 
 /** Build a Socket.IO room name for a channel */
@@ -1061,25 +2491,15 @@ declare class ShadowSocket {
         content: string;
         threadId?: string;
         replyToId?: string;
+        mentions?: ShadowMessageMention[];
+        metadata?: Record<string, unknown>;
     }): void;
-    /** Send a typing indicator */
-    sendTyping(channelId: string): void;
+    /** Send or clear a typing indicator */
+    sendTyping(channelId: string, typing?: boolean): 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 };
+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 };