@shadowob/sdk 1.1.7 → 1.1.8

package/dist/server-app-qqsBtGmE.d.cts

@@ -0,0 +1,2445 @@
+import { MessageCardSource, MessageMention, MessageCard, OAuthLinkCard, BuddyInboxAdmissionMode, BuddyInboxAdmissionPendingDelivery, BuddyInboxAdmissionPolicy, BuddyInboxAdmissionRule, BuddyInboxAdmissionSubjectKind, MentionSuggestionTrigger, MentionSuggestion } from '@shadowob/shared';
+
+/** Message returned by the Shadow REST API and Socket.IO broadcasts */
+interface ShadowMessage {
+    id: string;
+    content: string;
+    channelId: string;
+    authorId: string;
+    threadId?: string | null;
+    replyToId?: string | null;
+    isPinned?: boolean;
+    createdAt: string;
+    updatedAt: string;
+    author?: {
+        id: string;
+        username: string;
+        displayName?: string | null;
+        avatarUrl?: string | null;
+        isBot?: boolean;
+    };
+    attachments?: ShadowAttachment[];
+    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;
+    cards?: ShadowMessageCard[];
+    commerceCards?: Array<ShadowCommerceProductCard | ShadowCommerceOfferCardInput>;
+    oauthLinkCards?: ShadowOAuthLinkCard[];
+    [key: string]: unknown;
+}
+interface ShadowCommerceOfferCardInput {
+    id?: string;
+    kind: 'offer';
+    offerId: string;
+}
+type ShadowMessageMention = MessageMention;
+type ShadowMessageCard = MessageCard;
+type ShadowMessageCardSource = MessageCardSource;
+type ShadowOAuthLinkCard = OAuthLinkCard;
+type ShadowMentionSuggestion = MentionSuggestion;
+type ShadowMentionSuggestionTrigger = MentionSuggestionTrigger;
+type ShadowBuddyInboxAdmissionMode = BuddyInboxAdmissionMode;
+type ShadowBuddyInboxAdmissionSubjectKind = BuddyInboxAdmissionSubjectKind;
+type ShadowBuddyInboxAdmissionRule = BuddyInboxAdmissionRule;
+type ShadowBuddyInboxAdmissionPolicy = BuddyInboxAdmissionPolicy;
+type ShadowBuddyInboxAdmissionPendingDelivery = BuddyInboxAdmissionPendingDelivery;
+interface ShadowBuddyInboxSummary {
+    agent: {
+        id: string;
+        ownerId: string;
+        status?: string | null;
+        user?: ShadowUser | null;
+    };
+    channel: ShadowChannel | null;
+    canManage: boolean;
+    server?: {
+        id: string;
+        name: string;
+        slug?: string | null;
+    };
+}
+interface ShadowEnsureBuddyInboxResult {
+    channel: ShadowChannel;
+    agent: ShadowBuddyInboxSummary['agent'];
+    created: boolean;
+}
+interface ShadowBuddyInboxAdmissionPolicyResult {
+    channel: ShadowChannel | null;
+    policy: ShadowBuddyInboxAdmissionPolicy;
+}
+interface ShadowBuddyInboxAdmissionPendingResult {
+    channel: ShadowChannel | null;
+    pending: ShadowBuddyInboxAdmissionPendingDelivery[];
+}
+interface ShadowBuddyInboxAdmissionPendingActionResult {
+    channel: ShadowChannel | null;
+    pending: ShadowBuddyInboxAdmissionPendingDelivery;
+    message?: ShadowMessage;
+    policy?: ShadowBuddyInboxAdmissionPolicy;
+}
+interface ShadowInboxTaskInput {
+    title: string;
+    body?: string;
+    priority?: 'low' | 'normal' | 'high' | 'urgent';
+    idempotencyKey?: string;
+    source?: ShadowMessageCardSource;
+    data?: Record<string, unknown>;
+}
+interface ShadowAttachment {
+    id: string;
+    filename: string;
+    url: string;
+    contentType: string;
+    size: number;
+    width?: number | null;
+    height?: number | null;
+    workspaceNodeId?: string | null;
+    kind?: 'file' | 'image' | 'voice';
+    durationMs?: number | null;
+    audioCodec?: string | null;
+    audioContainer?: string | null;
+    waveformPeaks?: number[] | null;
+    waveformVersion?: number | null;
+    transcript?: {
+        id: string;
+        status: 'pending' | 'processing' | 'ready' | 'failed';
+        text: string | null;
+        language: string | null;
+        source: 'client' | 'server' | 'runtime';
+        provider?: string | null;
+        confidence?: number | null;
+        errorCode?: string | null;
+        updatedAt?: string;
+    } | null;
+    playback?: {
+        played: boolean;
+        completed: boolean;
+        lastPositionMs: number;
+        playedCount?: number;
+    } | null;
+}
+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';
+type ShadowServerAppApprovalMode = 'none' | 'first_time' | 'every_time' | 'policy';
+interface ShadowServerAppCommand {
+    name: string;
+    title?: string;
+    description?: string;
+    help?: {
+        summary?: string;
+        usage?: string;
+        details?: string;
+        examples?: readonly {
+            title?: string;
+            command?: string;
+            input?: unknown;
+        }[];
+        schemaRef?: string;
+    };
+    path: string;
+    method?: 'POST';
+    input?: 'json' | 'multipart';
+    inputSchema?: Record<string, unknown>;
+    permission: string;
+    action: ShadowServerAppAction;
+    dataClass: ShadowServerAppDataClass;
+    approvalMode?: ShadowServerAppApprovalMode;
+    binary?: {
+        supported?: boolean;
+        field?: string;
+        maxBytes?: number;
+        contentTypes?: readonly string[];
+    };
+}
+interface ShadowServerAppRealtimeSpec {
+    transports?: readonly ('sse' | 'websocket')[];
+    subscribe?: {
+        events?: readonly string[];
+        help?: string;
+    };
+    publish?: {
+        command?: string;
+        events?: readonly string[];
+        help?: string;
+    };
+    stateSync?: {
+        model?: 'snapshot-patch' | 'frame-sync' | 'lockstep';
+        authority?: 'server' | 'client';
+        tickRate?: number;
+        help?: string;
+    };
+}
+interface ShadowServerAppManifest {
+    schemaVersion: 'shadow.app/1';
+    appKey: string;
+    name: string;
+    description?: string;
+    version?: string;
+    updatedAt?: string;
+    iconUrl: string;
+    iframe?: {
+        entry: string;
+        allowedOrigins: readonly string[];
+    };
+    api: {
+        baseUrl: string;
+        auth?: {
+            type: 'oauth2-bearer';
+        };
+    };
+    access?: {
+        defaultPermissions?: string[];
+        defaultApprovalMode?: ShadowServerAppApprovalMode;
+    };
+    commands: readonly ShadowServerAppCommand[];
+    skills?: readonly {
+        name: string;
+        description: string;
+        commandHints?: readonly string[];
+    }[];
+    events?: readonly string[];
+    help?: {
+        overview?: string;
+        usage?: string;
+        details?: string;
+        commandIndex?: string;
+    };
+    realtime?: ShadowServerAppRealtimeSpec;
+    binary?: {
+        supported: boolean;
+        maxBytes?: number;
+        contentTypes?: readonly string[];
+    };
+}
+interface ShadowServerAppIntegration {
+    id: string;
+    serverId: string;
+    appKey: string;
+    name: string;
+    description?: string | null;
+    iconUrl?: string | null;
+    manifestUrl?: string | null;
+    manifest: ShadowServerAppManifest;
+    manifestVersion?: string | null;
+    manifestUpdatedAt?: string | null;
+    manifestFetchedAt?: string | null;
+    iframeEntry?: string | null;
+    allowedOrigins: string[];
+    apiBaseUrl: string;
+    defaultPermissions: string[];
+    defaultApprovalMode: ShadowServerAppApprovalMode;
+    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: ShadowServerAppApprovalMode;
+    }>;
+}
+interface ShadowServerAppCommandApproval {
+    appKey: string;
+    appName: string;
+    commandName: string;
+    commandTitle: string;
+    commandDescription?: string | null;
+    permission: string;
+    action: ShadowServerAppAction;
+    dataClass: ShadowServerAppDataClass;
+    actorKind: string;
+    subjectKind: 'user' | 'buddy';
+    buddyAgentId?: string | null;
+    approvalMode: ShadowServerAppApprovalMode;
+    reason: 'not_default' | 'first_time' | 'every_time' | 'restricted' | 'policy';
+}
+interface ShadowServerAppCommandConsent {
+    id: string;
+    serverAppId: string;
+    appKey: string;
+    command: string;
+    permission: string;
+    subjectKind: 'user' | 'buddy';
+    subjectUserId?: string | null;
+    buddyAgentId?: string | null;
+    expiresAt?: string | null;
+}
+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 ShadowServerAppActorProfile {
+    id?: string | null;
+    username?: string | null;
+    displayName?: string | null;
+    avatarUrl?: string | null;
+}
+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;
+            profile?: ShadowServerAppActorProfile | null;
+        };
+        channelId?: string | null;
+        task?: {
+            messageId: string;
+            cardId: string;
+            claimId?: string | null;
+            workspaceId?: string | null;
+            scopes?: string[];
+        };
+        permission?: string;
+        action?: string;
+        dataClass?: string;
+    };
+}
+interface ShadowChannel {
+    id: string;
+    name: string;
+    type: string;
+    kind: 'server' | 'dm';
+    serverId: string | null;
+    description?: string | null;
+    position?: number;
+    isPrivate?: boolean;
+    isMember?: boolean;
+    otherUser?: ShadowUser | null;
+}
+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;
+}
+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;
+    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;
+    name: string;
+    channelId: string;
+    parentMessageId: string;
+    createdAt: string;
+}
+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;
+    createdBy: string;
+    usedBy?: string | null;
+    usedAt?: string | null;
+    isActive: boolean;
+    note?: string | null;
+    createdAt: string;
+}
+interface ShadowServer {
+    id: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    iconUrl: string | null;
+    bannerUrl: string | null;
+    isPublic: boolean;
+}
+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;
+} | {
+    kind: 'private_room';
+    serverId?: string;
+    serverSlug?: string;
+    namePrefix?: string;
+    buddyUserIds?: string[];
+    buddyTemplateSlug?: string;
+} | {
+    kind: 'cloud_deploy';
+    templateSlug: string;
+    buddyTemplateSlug?: string;
+    buddyUserIds?: string[];
+    resourceTier?: 'lightweight' | 'standard' | 'pro';
+} | {
+    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 | 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;
+    reply: boolean;
+    mentionOnly: boolean;
+    config: ShadowChannelPolicyConfig;
+}
+interface ShadowChannelPolicyConfig {
+    allowedTriggerUserIds?: string[];
+    triggerUserIds?: string[];
+    ownerId?: string;
+    activeTenantIds?: string[];
+    replyRequiresMention?: boolean;
+    [key: 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 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;
+    type: string;
+    policy: ShadowChannelPolicy;
+}
+interface ShadowRemoteServer {
+    id: string;
+    name: string;
+    slug?: string;
+    iconUrl?: string | null;
+    defaultPolicy: ShadowChannelPolicy;
+    channels: ShadowRemoteChannel[];
+}
+interface ShadowRemoteConfig {
+    agentId: string;
+    botUserId: string;
+    ownerId?: string;
+    buddyMode?: 'private' | 'shareable';
+    allowedServerIds?: string[];
+    activeTenantIds?: string[];
+    allowedTriggerUserIds?: 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 ShadowConnectorRuntimeInfo {
+    id: string;
+    label: string;
+    kind: 'openclaw' | 'cli';
+    status: 'available' | 'missing';
+    version?: string | null;
+    command?: string | null;
+    detectedAt?: string | null;
+}
+interface ShadowConnectorComputer {
+    id: string;
+    name: string;
+    status: 'pending' | 'online' | 'offline';
+    hostname: string | null;
+    os: string | null;
+    arch: string | null;
+    daemonVersion: string | null;
+    runtimes: ShadowConnectorRuntimeInfo[];
+    lastSeenAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ShadowConnectorBootstrapResult {
+    computer: ShadowConnectorComputer;
+    apiKey: string;
+    command: string;
+}
+interface TypingPayload {
+    channelId: string;
+    userId: string;
+    username: string;
+    displayName?: string | null;
+    typing?: boolean;
+}
+interface PresenceChangePayload {
+    userId: string;
+    status: 'online' | 'idle' | 'dnd' | 'offline';
+}
+interface PresenceActivityPayload {
+    userId: string;
+    activity: string | null;
+    channelId: string;
+    username?: string;
+    displayName?: string | null;
+}
+interface MemberJoinPayload {
+    channelId: string;
+    userId: string;
+}
+interface MemberLeavePayload {
+    channelId: string;
+    userId: string;
+}
+interface SlashCommandsUpdatedPayload {
+    channelId: string;
+    serverId?: string;
+    agentId?: string;
+    botUserId?: string;
+    commandCount?: number;
+}
+interface ReactionPayload {
+    messageId: string;
+    userId: string;
+    emoji: string;
+}
+interface MessageDeletedPayload {
+    id: string;
+    channelId: string;
+}
+interface ChannelCreatedPayload {
+    id: string;
+    name: string;
+    type: string;
+    serverId: string;
+}
+interface ChannelMemberAddedPayload {
+    channelId: string;
+    serverId?: string;
+    userId?: string;
+}
+interface ChannelMemberRemovedPayload {
+    channelId: string;
+    serverId?: string;
+    userId?: string;
+}
+interface ServerJoinedPayload {
+    serverId: string;
+    serverName: string;
+}
+interface PolicyChangedPayload {
+    agentId: string;
+    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;
+    friendId: string;
+    status: 'pending' | 'accepted' | 'rejected';
+    createdAt: string;
+    user?: ShadowUser;
+    friend?: ShadowUser;
+}
+interface ShadowOAuthApp {
+    id: string;
+    name: string;
+    clientId: string;
+    clientSecret?: string;
+    redirectUris: string[];
+    scopes: string[];
+    createdAt: string;
+}
+interface ShadowOAuthConsent {
+    id: string;
+    appId: string;
+    appName: string;
+    scopes: string[];
+    createdAt: string;
+}
+interface ShadowOAuthToken {
+    access_token: string;
+    token_type: string;
+    expires_in: number;
+    refresh_token?: string;
+    scope: string;
+}
+interface ShadowListing {
+    id: string;
+    agentId: string;
+    title: string;
+    description: string;
+    pricePerHour: number;
+    currency: string;
+    tags: string[];
+    isActive: boolean;
+    createdAt: string;
+    agent?: {
+        id: string;
+        name: string;
+        status: string;
+    };
+}
+interface ShadowContract {
+    id: string;
+    listingId: string;
+    tenantId: string;
+    ownerId: string;
+    status: string;
+    startedAt: string;
+    expiresAt: string;
+    totalCost: number;
+    createdAt: string;
+}
+interface ShadowShop {
+    id: string;
+    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;
+        shopName?: string | null;
+        deliveryPromise?: 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;
+    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: {
+        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 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;
+        fileId: string;
+        status: string;
+        expiresAt: string;
+    };
+    viewerUrl: string;
+}
+interface ShadowCategory {
+    id: string;
+    shopId: string;
+    name: string;
+    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;
+    summary?: string | null;
+    price?: number;
+    basePrice?: number;
+    currency: string;
+    stock?: number;
+    status: string;
+    specNames?: string[];
+    tags?: string[];
+    globalPublic?: boolean;
+    salesCount?: number;
+    avgRating?: number;
+    ratingCount?: number;
+    billingMode?: 'one_time' | 'fixed_duration' | 'subscription';
+    entitlementConfig?: ShadowProductEntitlementConfig | ShadowProductEntitlementConfig[] | null;
+    media?: ShadowProductMedia[];
+    skus?: ShadowProductSku[];
+    images?: string[];
+    createdAt: string;
+}
+interface ShadowMarketplaceProduct extends ShadowProduct {
+    price: number;
+    imageUrl?: string | null;
+    shop: {
+        id: string;
+        name: string;
+        scopeKind: 'server' | 'user' | string;
+        logoUrl?: string | null;
+        bannerUrl?: string | null;
+        server?: {
+            id: string;
+            name: string;
+            slug?: string | null;
+            iconUrl?: string | null;
+        } | null;
+        owner?: {
+            id: string;
+            username: string;
+            displayName?: string | null;
+            avatarUrl?: string | null;
+        } | null;
+    };
+    links?: {
+        product?: string | null;
+        shop?: string | null;
+        server?: string | null;
+        providerProfile?: string | null;
+    };
+}
+interface ShadowMarketplaceProductsResponse {
+    products: ShadowMarketplaceProduct[];
+    total: number;
+    hasMore: boolean;
+    filters?: {
+        q?: string | null;
+        tags?: string[];
+        scope?: string | null;
+    };
+}
+interface ShadowMarketplaceCategory {
+    tag: string;
+    title: string;
+    productCount: number;
+    salesCount: number;
+    ratingCount: number;
+    avgRating: number;
+    score: number;
+    href: string;
+}
+interface ShadowMarketplaceCategoriesResponse {
+    categories: ShadowMarketplaceCategory[];
+    total: number;
+    filters?: {
+        q?: string | null;
+    };
+}
+interface ShadowCartItem {
+    id: string;
+    productId: string;
+    quantity: number;
+    product?: ShadowProduct;
+}
+interface ShadowOrder {
+    id: string;
+    orderNo?: string;
+    shopId: string;
+    buyerId: string;
+    status: 'pending' | 'paid' | 'processing' | 'shipped' | 'delivered' | 'completed' | 'cancelled' | 'refunded' | string;
+    totalAmount: number;
+    currency: string;
+    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 {
+    id: string;
+    orderId: string;
+    productId: string;
+    userId: string;
+    rating: number;
+    content: string;
+    reply?: string | null;
+    createdAt: string;
+}
+interface ShadowWallet {
+    id: string;
+    userId: string;
+    balance: number;
+    currency: string;
+}
+interface ShadowTransaction {
+    id: string;
+    walletId: string;
+    type: string;
+    amount: number;
+    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;
+    title: string;
+    description: string;
+    reward: number;
+    status: string;
+    claimedAt?: string | null;
+}
+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;
+    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';
+    mutedServerIds: string[];
+    mutedChannelIds: string[];
+}
+/** Events the server pushes to the client */
+interface ServerEventMap {
+    'message:new': (message: ShadowMessage) => void;
+    'message:updated': (message: ShadowMessage) => void;
+    'message:deleted': (payload: MessageDeletedPayload) => void;
+    '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;
+    'channel:created': (payload: ChannelCreatedPayload) => void;
+    '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: {
+        message: string;
+    }) => void;
+}
+/** Events the client sends to the server */
+interface ClientEventMap {
+    'channel:join': (data: {
+        channelId: string;
+    }, ack?: (res: {
+        ok: boolean;
+    }) => void) => void;
+    'channel:leave': (data: {
+        channelId: string;
+    }) => void;
+    '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;
+        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';
+    }) => void;
+    'presence:activity': (data: {
+        channelId: string;
+        activity: string | null;
+    }) => void;
+}
+
+type ShadowServerAppFetch = typeof fetch;
+interface ShadowServerAppCommandContext {
+    protocol: 'shadow.app/1';
+    serverId: string;
+    serverAppId: string;
+    appKey: string;
+    command: string;
+    actor: {
+        kind: string;
+        userId: string | null;
+        buddyAgentId?: string | null;
+        ownerId?: string | null;
+        profile?: ShadowServerAppActorProfile | null;
+    };
+    channelId?: string | null;
+    task?: {
+        messageId: string;
+        cardId: string;
+        claimId?: string | null;
+        channelId?: string | null;
+        workspaceId?: string | null;
+        scopes?: string[];
+    };
+    permission: string;
+    action: string;
+    dataClass: string;
+}
+interface ShadowServerAppCommandEnvelope<T = unknown> {
+    input: T;
+    context: ShadowServerAppCommandContext;
+}
+declare const SHADOW_SERVER_APP_PROTOCOL: "shadow.app/1";
+declare const SHADOW_SERVER_APP_COMMAND_COMPLETED_EVENT: "server_app.command.completed";
+declare const SHADOW_SERVER_APP_COMMAND_FAILED_EVENT: "server_app.command.failed";
+declare const SHADOW_SERVER_APP_COMMAND_EVENTS: readonly ["server_app.command.completed", "server_app.command.failed"];
+type ShadowServerAppCommandEventType = (typeof SHADOW_SERVER_APP_COMMAND_EVENTS)[number];
+type ShadowServerAppInboxTaskPriority = 'low' | 'normal' | 'high' | 'urgent';
+interface ShadowServerAppInboxTaskResource {
+    kind: string;
+    id: string;
+    label?: string;
+    url?: string;
+    [key: string]: unknown;
+}
+interface ShadowServerAppInboxTaskOutbox {
+    title: string;
+    body?: string;
+    priority?: ShadowServerAppInboxTaskPriority;
+    agentId?: string;
+    agentUserId?: string;
+    assigneeLabel?: string;
+    idempotencyKey?: string;
+    resource?: ShadowServerAppInboxTaskResource;
+    data?: Record<string, unknown>;
+    required?: boolean;
+}
+interface ShadowServerAppInboxDelivery {
+    agentId?: string;
+    agentUserId?: string;
+    channelId?: string;
+    messageId?: string;
+    cardId?: string | null;
+    taskId?: string | null;
+    pendingId?: string | null;
+    idempotencyKey?: string;
+    error?: string;
+}
+interface ShadowServerAppInboxDeliveryError {
+    agentId?: string;
+    agentUserId?: string;
+    assigneeLabel?: string;
+    title?: string;
+    error: string;
+}
+interface ShadowServerAppChannelMessageOutbox {
+    content: string;
+    channelId?: string;
+    channelName?: string;
+    metadata?: Record<string, unknown>;
+    idempotencyKey?: string;
+}
+interface ShadowServerAppChannelMessageDelivery {
+    channelId: string;
+    messageId: string;
+    idempotencyKey?: string;
+}
+interface ShadowServerAppChannelMessageDeliveryError {
+    channelId?: string;
+    channelName?: string;
+    idempotencyKey?: string;
+    error: string;
+}
+type ShadowServerAppInboxTarget = {
+    agentId: string;
+    channelId?: string;
+} | {
+    channelId: string;
+    agentId?: string;
+};
+interface ShadowServerAppOutboxPayload {
+    inboxTasks?: ShadowServerAppInboxTaskOutbox[];
+    channelMessages?: ShadowServerAppChannelMessageOutbox[];
+    deliveries?: ShadowServerAppInboxDelivery[];
+    errors?: ShadowServerAppInboxDeliveryError[];
+    channelMessageDeliveries?: ShadowServerAppChannelMessageDelivery[];
+    channelMessageErrors?: ShadowServerAppChannelMessageDeliveryError[];
+}
+interface ShadowServerAppResultShadow {
+    protocol: typeof SHADOW_SERVER_APP_PROTOCOL;
+    outbox?: ShadowServerAppOutboxPayload;
+}
+type ShadowServerAppResultWithShadow<TResult extends Record<string, unknown>> = TResult & {
+    shadow?: ShadowServerAppResultShadow;
+};
+interface ShadowServerAppCommandSuccessResponse<TResult = unknown> {
+    ok: true;
+    result: TResult;
+    shadow?: ShadowServerAppResultShadow;
+}
+interface ShadowServerAppCommandFailureResponse {
+    ok: false;
+    error: string;
+    issues?: ShadowServerAppValidationIssue[] | unknown;
+}
+type ShadowServerAppCommandResponse<TResult = unknown> = ShadowServerAppCommandSuccessResponse<TResult> | ShadowServerAppCommandFailureResponse;
+interface ShadowServerAppBridgeCommandRequest {
+    type: 'shadow.app.command.request';
+    requestId: string;
+    appKey?: string;
+    commandName: string;
+    input?: unknown;
+    channelId?: string;
+    task?: {
+        messageId: string;
+        cardId: string;
+        claimId?: string;
+    };
+}
+interface ShadowServerAppBridgeInboxesRequest {
+    type: 'shadow.app.inboxes.request';
+    requestId: string;
+    appKey?: string;
+}
+interface ShadowServerAppBridgeEnqueueInboxTaskRequest {
+    type: 'shadow.app.inbox.enqueue.request';
+    requestId: string;
+    appKey?: string;
+    target: ShadowServerAppInboxTarget;
+    task: ShadowServerAppInboxTaskOutbox;
+}
+type ShadowServerAppBridgeRequest = ShadowServerAppBridgeCommandRequest | ShadowServerAppBridgeInboxesRequest | ShadowServerAppBridgeEnqueueInboxTaskRequest;
+interface ShadowServerAppHostAppRef {
+    id?: string | null;
+    appId?: string | null;
+    appKey: string;
+    serverId?: string | null;
+    name?: string | null;
+    label?: string | null;
+}
+interface ShadowServerAppHostInboxTaskRequestInput {
+    serverIdOrSlug: string;
+    target: ShadowServerAppInboxTarget;
+    task: ShadowServerAppInboxTaskOutbox;
+    app: ShadowServerAppHostAppRef;
+    commandName?: string;
+}
+interface ShadowServerAppResolvedInboxTaskRequest {
+    endpoint: string;
+    body: ShadowInboxTaskInput;
+}
+interface ShadowServerAppInboxDeliveryFromMessageInput {
+    target: ShadowServerAppInboxTarget;
+    message: unknown;
+    idempotencyKey?: string;
+}
+type ShadowServerAppBridgeResponseType = 'shadow.app.command.response' | 'shadow.app.inboxes.response' | 'shadow.app.inbox.enqueue.response';
+interface ShadowServerAppBridgeSuccessResponse<TResult = unknown> {
+    type: ShadowServerAppBridgeResponseType;
+    requestId: string;
+    ok: true;
+    result: TResult;
+}
+interface ShadowServerAppBridgeFailureResponse {
+    type: ShadowServerAppBridgeResponseType;
+    requestId: string;
+    ok: false;
+    error: string;
+}
+type ShadowServerAppBridgeResponse<TResult = unknown> = ShadowServerAppBridgeSuccessResponse<TResult> | ShadowServerAppBridgeFailureResponse;
+declare function shadowServerAppInboxTaskEndpoint(serverIdOrSlug: string, target: ShadowServerAppInboxTarget): string;
+declare function buildShadowServerAppInboxTaskRequest(input: ShadowServerAppHostInboxTaskRequestInput): ShadowServerAppResolvedInboxTaskRequest;
+declare function getShadowServerAppTaskCardId(message: unknown): string | null;
+declare function buildShadowServerAppInboxDelivery(input: ShadowServerAppInboxDeliveryFromMessageInput): ShadowServerAppInboxDelivery;
+declare function getShadowServerAppInboxDeliveries(payload: unknown): ShadowServerAppInboxDelivery[];
+declare function getShadowServerAppInboxErrors(payload: unknown): ShadowServerAppInboxDeliveryError[];
+declare function getShadowServerAppChannelMessageDeliveries(payload: unknown): ShadowServerAppChannelMessageDelivery[];
+declare function getShadowServerAppChannelMessageErrors(payload: unknown): ShadowServerAppChannelMessageDeliveryError[];
+declare function unwrapShadowServerAppCommandPayload<TResult = unknown>(payload: unknown): TResult;
+declare class ShadowServerAppOutbox {
+    private readonly inboxTasks;
+    private readonly channelMessages;
+    enqueueInboxTask(task: ShadowServerAppInboxTaskOutbox): this;
+    enqueueInboxTasks(tasks: ShadowServerAppInboxTaskOutbox[]): this;
+    sendChannelMessage(message: ShadowServerAppChannelMessageOutbox): this;
+    sendChannelMessages(messages: ShadowServerAppChannelMessageOutbox[]): this;
+    toShadow(): ShadowServerAppResultShadow;
+    attachTo<TResult extends Record<string, unknown>>(result: TResult): ShadowServerAppResultWithShadow<TResult>;
+}
+interface ShadowServerAppActorRef {
+    kind: string;
+    id: string;
+    userId: string | null;
+    buddyAgentId: string | null;
+    ownerId: string | null;
+    displayName: string;
+    avatarUrl: string | null;
+}
+interface ShadowServerAppCommandParseError {
+    ok: false;
+    status: 400 | 401 | 403 | 502;
+    error: string;
+    issues?: ShadowServerAppValidationIssue[];
+}
+interface ShadowServerAppCommandParseSuccess<T = unknown> {
+    ok: true;
+    envelope: ShadowServerAppCommandEnvelope<T>;
+}
+type ShadowServerAppCommandParseResult<T = unknown> = ShadowServerAppCommandParseSuccess<T> | ShadowServerAppCommandParseError;
+interface ShadowServerAppManifestOptions {
+    publicBaseUrl?: string;
+    apiBaseUrl?: string;
+    port?: number;
+    iframePath?: string;
+    iconPath?: string;
+    allowedOrigins?: string[];
+}
+interface ShadowServerAppIntrospectionInput {
+    token: string;
+    serverId: string;
+    appKey: string;
+    shadowBaseUrl?: string;
+    fetchImpl?: ShadowServerAppFetch;
+}
+interface ShadowServerAppCommandRequestInput {
+    authorizationHeader?: string | null;
+    serverIdHeader?: string | null;
+    appKeyHeader?: string | null;
+    expectedCommand: string;
+    requestBody?: string;
+    requestInput?: unknown;
+    shadowBaseUrl?: string;
+    fetchImpl?: ShadowServerAppFetch;
+}
+interface ShadowServerAppCommandRuntimeRequest {
+    authorizationHeader?: string | null;
+    serverIdHeader?: string | null;
+    appKeyHeader?: string | null;
+    requestBody?: string;
+    requestInput?: unknown;
+}
+interface ShadowServerAppRuntimeOptions {
+    shadowBaseUrl?: string;
+    fetchImpl?: ShadowServerAppFetch;
+}
+interface ShadowServerAppCommandHandlerContext {
+    context: ShadowServerAppCommandContext;
+    actor: ShadowServerAppActorRef;
+}
+type ShadowServerAppCommandHandler<TInput = unknown, TResult = unknown> = (input: TInput, context: ShadowServerAppCommandHandlerContext) => TResult | Promise<TResult>;
+type ShadowServerAppCommandHandlers<TManifest extends ShadowServerAppManifest> = {
+    [TCommand in TManifest['commands'][number] as TCommand['name']]: ShadowServerAppCommandHandler<ShadowServerAppCommandInput<TManifest, TCommand['name']>>;
+};
+interface ShadowServerAppExecutionSuccess<TResult = unknown> {
+    ok: true;
+    status: 200;
+    body: ShadowServerAppCommandSuccessResponse<TResult>;
+}
+interface ShadowServerAppExecutionFailure {
+    ok: false;
+    status: number;
+    body: ShadowServerAppCommandFailureResponse;
+}
+type ShadowServerAppExecutionResult<TResult = unknown> = ShadowServerAppExecutionSuccess<TResult> | ShadowServerAppExecutionFailure;
+interface ShadowServerAppValidationIssue {
+    path: string;
+    message: string;
+}
+type ShadowServerAppCommandName<TManifest extends ShadowServerAppManifest> = TManifest['commands'][number]['name'];
+type JsonSchemaEnum<TSchema> = TSchema extends {
+    enum: readonly (infer TValue)[];
+} ? TValue : never;
+type JsonSchemaProperties<TSchema> = TSchema extends {
+    properties: infer TProperties;
+} ? TProperties : Record<string, never>;
+type JsonSchemaRequiredKeys<TSchema, TProperties> = TSchema extends {
+    required: readonly (infer TKey)[];
+} ? string extends TKey ? never : Extract<TKey, keyof TProperties> : never;
+type Simplify<T> = {
+    [TKey in keyof T]: T[TKey];
+} & {};
+type JsonSchemaAdditionalProperties<TSchema> = TSchema extends {
+    additionalProperties: infer TAdditionalProperties;
+} ? TAdditionalProperties extends false ? unknown : TAdditionalProperties extends true ? Record<string, unknown> : TAdditionalProperties extends Record<string, unknown> ? Record<string, JsonSchemaToType<TAdditionalProperties>> : unknown : unknown;
+type JsonSchemaToType<TSchema> = TSchema extends {
+    oneOf: readonly (infer TOption)[];
+} ? JsonSchemaToType<TOption> : [JsonSchemaEnum<TSchema>] extends [never] ? TSchema extends {
+    type: 'string';
+} ? string : TSchema extends {
+    type: 'number' | 'integer';
+} ? number : TSchema extends {
+    type: 'boolean';
+} ? boolean : TSchema extends {
+    type: 'array';
+    items: infer TItems;
+} ? JsonSchemaToType<TItems>[] : TSchema extends {
+    type: 'object';
+} ? JsonSchemaObjectToType<TSchema> : unknown : JsonSchemaEnum<TSchema>;
+type JsonSchemaObjectToType<TSchema> = JsonSchemaProperties<TSchema> extends infer TProperties ? Simplify<{
+    [TKey in JsonSchemaRequiredKeys<TSchema, TProperties>]: JsonSchemaToType<TProperties[TKey]>;
+} & {
+    [TKey in Exclude<keyof TProperties, JsonSchemaRequiredKeys<TSchema, TProperties>>]?: JsonSchemaToType<TProperties[TKey]>;
+}> & JsonSchemaAdditionalProperties<TSchema> : Record<string, unknown>;
+type ExtractShadowServerAppCommand<TManifest extends ShadowServerAppManifest, TCommandName extends ShadowServerAppCommandName<TManifest>> = Extract<TManifest['commands'][number], {
+    name: TCommandName;
+}>;
+type ShadowServerAppCommandInput<TManifest extends ShadowServerAppManifest, TCommandName extends ShadowServerAppCommandName<TManifest>> = ExtractShadowServerAppCommand<TManifest, TCommandName> extends {
+    inputSchema: infer TSchema;
+} ? JsonSchemaToType<TSchema> : Record<string, never>;
+declare function extractShadowServerAppBearerToken(value?: string | null): string | null;
+declare function normalizeShadowServerAppCommandInput(value: unknown): unknown;
+declare function createShadowServerAppManifest<TManifest extends ShadowServerAppManifest>(manifest: TManifest, options?: ShadowServerAppManifestOptions): TManifest;
+declare function defineShadowServerApp<const TManifest extends ShadowServerAppManifest>(manifest: TManifest, options?: ShadowServerAppRuntimeOptions): ShadowServerAppRuntime<TManifest>;
+declare class ShadowServerAppCommandError extends Error {
+    readonly status: number;
+    readonly issues?: ShadowServerAppValidationIssue[] | unknown;
+    constructor(status: number, error: string, issues?: ShadowServerAppValidationIssue[] | unknown);
+}
+declare function shadowServerAppError(status: number, error: string, issues?: ShadowServerAppValidationIssue[] | unknown): ShadowServerAppCommandError;
+declare class ShadowServerAppRuntime<const TManifest extends ShadowServerAppManifest> {
+    readonly sourceManifest: TManifest;
+    private readonly options;
+    constructor(sourceManifest: TManifest, options?: ShadowServerAppRuntimeOptions);
+    manifest(options?: ShadowServerAppManifestOptions): TManifest;
+    defineCommands(handlers: ShadowServerAppCommandHandlers<TManifest>): ShadowServerAppCommandHandlers<TManifest>;
+    actor(envelopeOrContext: ShadowServerAppCommandEnvelope | ShadowServerAppCommandContext): ShadowServerAppActorRef;
+    error(status: number, error: string, issues?: ShadowServerAppValidationIssue[] | unknown): ShadowServerAppCommandError;
+    parseCommand<TCommandName extends ShadowServerAppCommandName<TManifest>>(commandName: TCommandName, request: ShadowServerAppCommandRuntimeRequest): Promise<ShadowServerAppCommandParseResult<ShadowServerAppCommandInput<TManifest, TCommandName>>>;
+    executeCommand<TCommandName extends ShadowServerAppCommandName<TManifest>>(commandName: TCommandName, request: ShadowServerAppCommandRuntimeRequest, handlers: ShadowServerAppCommandHandlers<TManifest>): Promise<ShadowServerAppExecutionResult>;
+    executeLocal<TCommandName extends ShadowServerAppCommandName<TManifest>>(commandName: TCommandName, input: unknown, context: ShadowServerAppCommandContext, handlers: ShadowServerAppCommandHandlers<TManifest>): Promise<ShadowServerAppExecutionResult>;
+    private executeEnvelope;
+}
+declare function introspectShadowServerAppToken(input: ShadowServerAppIntrospectionInput): Promise<ShadowServerAppTokenIntrospection | null>;
+declare function parseShadowServerAppCommandRequest<T = unknown>(input: ShadowServerAppCommandRequestInput): Promise<ShadowServerAppCommandParseResult<T>>;
+declare function validateShadowServerAppJsonSchema(schema: Readonly<Record<string, unknown>> | undefined, value: unknown): {
+    ok: true;
+} | {
+    ok: false;
+    issues: ShadowServerAppValidationIssue[];
+};
+declare function shadowServerAppActorDisplayName(envelopeOrContext: ShadowServerAppCommandEnvelope | ShadowServerAppCommandContext): string;
+declare function shadowServerAppActorAvatarUrl(envelopeOrContext: ShadowServerAppCommandEnvelope | ShadowServerAppCommandContext): string | null;
+declare function shadowServerAppActorRef(envelopeOrContext: ShadowServerAppCommandEnvelope | ShadowServerAppCommandContext): ShadowServerAppActorRef;
+
+export { type ShadowInteractiveActionResult as $, type ShadowServerJoinRequestStatus as A, type ShadowMember as B, type ShadowAddAgentsToServerResult as C, type ShadowChannel as D, type ShadowChannelBootstrap as E, type ShadowChannelAccess as F, type ShadowChannelJoinRequestResult as G, type ShadowChannelJoinRequestStatus as H, type ShadowVoiceState as I, type ShadowVoiceJoinResult as J, type ShadowVoiceRenewResult as K, type ShadowVoiceLeaveResult as L, type ShadowVoicePolicy as M, type ShadowMessageMention as N, type ShadowMessage as O, type ShadowMentionSuggestionTrigger as P, type ShadowMentionSuggestion as Q, type ShadowBuddyInboxSummary as R, type ShadowAuthResponse as S, type ShadowEnsureBuddyInboxResult as T, type ShadowBuddyInboxAdmissionPolicyResult as U, type ShadowBuddyInboxAdmissionPolicy as V, type ShadowBuddyInboxAdmissionPendingResult as W, type ShadowBuddyInboxAdmissionPendingActionResult as X, type ShadowInboxTaskInput as Y, type ShadowMessageCard as Z, type ShadowInteractiveActionInput as _, type ShadowUser as a, type JsonSchemaToType as a$, type ShadowInteractiveState as a0, type ShadowThread as a1, type ShadowNotification as a2, type ShadowInviteCode as a3, type ShadowAttachment as a4, type ShadowMediaVariant as a5, type ShadowSignedMediaUrl as a6, type ShadowFriendship as a7, type ShadowScopedUnread as a8, type ShadowNotificationPreferences as a9, type ShadowDiyCloudRunStatus as aA, type ShadowDiyCloudRun as aB, type ShadowDiyCloudRunEvent as aC, type ShadowCloudDeploymentManifest as aD, type ShadowCloudDeploymentTemplateSyncResult as aE, type ShadowCloudDeploymentRuntimeResponse as aF, type ShadowCloudDeploymentBackup as aG, type ShadowCloudProviderCatalog as aH, type ShadowCloudProviderProfile as aI, type ShadowCloudProviderModel as aJ, type ShadowRechargeConfig as aK, type ShadowRechargeIntent as aL, type ShadowRechargeHistory as aM, type ShadowPaymentOrder as aN, type ShadowEntitlement as aO, type ShadowOAuthCommerceEntitlementAccess as aP, type ShadowOAuthCommerceEntitlementRedeemInput as aQ, type ShadowOAuthCommerceEntitlementRedeemResult as aR, type ShadowEntitlementProvisioning as aS, type ShadowTask as aT, type ShadowMarketplaceProductsResponse as aU, type ShadowMarketplaceCategoriesResponse as aV, type ServerEventMap as aW, type ChannelCreatedPayload as aX, type ChannelMemberAddedPayload as aY, type ChannelMemberRemovedPayload as aZ, type ClientEventMap as a_, type ShadowOAuthApp as aa, type ShadowOAuthToken as ab, type ShadowOAuthConsent as ac, type ShadowOAuthLinkCard as ad, type ShadowListing as ae, type ShadowContract as af, type ShadowShop as ag, type ShadowProduct as ah, type ShadowCommerceProductContext as ai, type ShadowEntitlementPurchaseResult as aj, type ShadowCommerceCheckoutPreview as ak, type ShadowCommunityAssetDefinition as al, type ShadowCommerceProductPickerResponse as am, type ShadowPaidFileOpenResult as an, type ShadowCategory as ao, type ShadowCartItem as ap, type ShadowOrder as aq, type ShadowReview as ar, type ShadowWallet as as, type ShadowTransaction as at, type ShadowCommunityAsset as au, type ShadowCommunityAssetGrant as av, type ShadowEconomyTip as aw, type ShadowEconomyGift as ax, type ShadowSettlementLine as ay, type ShadowDiyCloudGenerateInput as az, type ShadowMembership as b, type ShadowServerAppCommandParseSuccess as b$, type MemberJoinPayload as b0, type MemberLeavePayload as b1, type MessageDeletedPayload as b2, type PolicyChangedPayload as b3, type PresenceActivityPayload as b4, type PresenceChangePayload as b5, type ReactionPayload as b6, SHADOW_SERVER_APP_COMMAND_COMPLETED_EVENT as b7, SHADOW_SERVER_APP_COMMAND_EVENTS as b8, SHADOW_SERVER_APP_COMMAND_FAILED_EVENT as b9, type ShadowServerAppActorProfile as bA, type ShadowServerAppActorRef as bB, type ShadowServerAppBridgeCommandRequest as bC, type ShadowServerAppBridgeEnqueueInboxTaskRequest as bD, type ShadowServerAppBridgeFailureResponse as bE, type ShadowServerAppBridgeInboxesRequest as bF, type ShadowServerAppBridgeRequest as bG, type ShadowServerAppBridgeResponse as bH, type ShadowServerAppBridgeResponseType as bI, type ShadowServerAppBridgeSuccessResponse as bJ, type ShadowServerAppChannelMessageDelivery as bK, type ShadowServerAppChannelMessageDeliveryError as bL, type ShadowServerAppChannelMessageOutbox as bM, type ShadowServerAppCommand as bN, type ShadowServerAppCommandApproval as bO, type ShadowServerAppCommandContext as bP, type ShadowServerAppCommandEnvelope as bQ, ShadowServerAppCommandError as bR, type ShadowServerAppCommandEventType as bS, type ShadowServerAppCommandFailureResponse as bT, type ShadowServerAppCommandHandler as bU, type ShadowServerAppCommandHandlerContext as bV, type ShadowServerAppCommandHandlers as bW, type ShadowServerAppCommandInput as bX, type ShadowServerAppCommandName as bY, type ShadowServerAppCommandParseError as bZ, type ShadowServerAppCommandParseResult as b_, SHADOW_SERVER_APP_PROTOCOL as ba, type ServerJoinedPayload as bb, type ShadowBuddyInboxAdmissionMode as bc, type ShadowBuddyInboxAdmissionPendingDelivery as bd, type ShadowBuddyInboxAdmissionRule as be, type ShadowBuddyInboxAdmissionSubjectKind as bf, type ShadowChannelPolicy as bg, type ShadowCloudDeploymentStatus as bh, type ShadowCloudProviderEnvVar as bi, type ShadowCommerceProductCard as bj, type ShadowCommerceProductPickerGroup as bk, type ShadowConnectorRuntimeInfo as bl, type ShadowInteractiveBlock as bm, type ShadowInteractiveResponse as bn, type ShadowInteractiveSubmissionPending as bo, type ShadowMarketplaceCategory as bp, type ShadowMarketplaceProduct as bq, type ShadowMessageCardSource as br, type ShadowModelProxyModel as bs, type ShadowOAuthCommerceEntitlementRedemption as bt, type ShadowOAuthCommerceEntitlementSummary as bu, type ShadowProductEntitlementConfig as bv, type ShadowProductMedia as bw, type ShadowProductSku as bx, type ShadowRemoteChannel as by, type ShadowRemoteServer as bz, type ShadowPlayLaunchResult as c, type ShadowServerAppCommandRequestInput as c0, type ShadowServerAppCommandResponse as c1, type ShadowServerAppCommandSuccessResponse as c2, type ShadowServerAppExecutionFailure as c3, type ShadowServerAppExecutionResult as c4, type ShadowServerAppExecutionSuccess as c5, type ShadowServerAppFetch as c6, type ShadowServerAppHostAppRef as c7, type ShadowServerAppHostInboxTaskRequestInput as c8, type ShadowServerAppInboxDelivery as c9, defineShadowServerApp as cA, extractShadowServerAppBearerToken as cB, getShadowServerAppChannelMessageDeliveries as cC, getShadowServerAppChannelMessageErrors as cD, getShadowServerAppTaskCardId as cE, introspectShadowServerAppToken as cF, normalizeShadowServerAppCommandInput as cG, parseShadowServerAppCommandRequest as cH, shadowServerAppActorAvatarUrl as cI, shadowServerAppActorDisplayName as cJ, shadowServerAppActorRef as cK, shadowServerAppError as cL, shadowServerAppInboxTaskEndpoint as cM, validateShadowServerAppJsonSchema as cN, type ShadowServerAppCommandRuntimeRequest as cO, getShadowServerAppInboxDeliveries as cP, getShadowServerAppInboxErrors as cQ, unwrapShadowServerAppCommandPayload as cR, type ShadowServerAppInboxDeliveryError as ca, type ShadowServerAppInboxDeliveryFromMessageInput as cb, type ShadowServerAppInboxTarget as cc, type ShadowServerAppInboxTaskOutbox as cd, type ShadowServerAppInboxTaskPriority as ce, type ShadowServerAppInboxTaskResource as cf, type ShadowServerAppIntrospectionInput as cg, type ShadowServerAppManifestOptions as ch, ShadowServerAppOutbox as ci, type ShadowServerAppOutboxPayload as cj, type ShadowServerAppRealtimeSpec as ck, type ShadowServerAppResolvedInboxTaskRequest as cl, type ShadowServerAppResultShadow as cm, type ShadowServerAppResultWithShadow as cn, ShadowServerAppRuntime as co, type ShadowServerAppRuntimeOptions as cp, type ShadowServerAppValidationIssue as cq, type ShadowUsageProviderSnapshot as cr, type ShadowVoiceCredentials as cs, type ShadowVoiceParticipant as ct, type TypingPayload as cu, type VoiceParticipantPayload as cv, type VoicePolicyUpdatedPayload as cw, buildShadowServerAppInboxDelivery as cx, buildShadowServerAppInboxTaskRequest as cy, createShadowServerAppManifest as cz, type ShadowHomePlayCatalogItem as d, type ShadowModelProxyModelsResponse as e, type ShadowModelProxyBilling as f, type ShadowModelProxyChatCompletionRequest as g, type ShadowModelProxyChatCompletionResponse as h, type ShadowConnectorComputer as i, type ShadowConnectorBootstrapResult as j, type ShadowAgentUsageSnapshotInput as k, type ShadowRemoteConfig as l, type ShadowSlashCommand as m, type ShadowChannelSlashCommand as n, type ShadowServer as o, type ShadowServerAccess as p, type ShadowServerAppIntegration as q, type ShadowServerAppCatalogEntry as r, type ShadowServerAppManifest as s, type ShadowServerAppDiscovery as t, type ShadowServerAppApprovalMode as u, type ShadowServerAppCommandConsent as v, type ShadowServerAppSkillDocument as w, type ShadowServerAppLaunchContext as x, type ShadowServerAppTokenIntrospection as y, type ShadowServerJoinRequestResult as z };