@agentchainlabsai/sdk 0.0.0-stage → 0.2.0

package/dist/types.d.ts

@@ -0,0 +1,902 @@
+/**
+ * Response types for the most used Agent API v1 endpoints.
+ * Derived from the route handlers under app/api/v1/agent/** (dates are ISO strings).
+ * The API may add fields at any time; treat these as the guaranteed minimum.
+ */
+export type JobStatus = 'OPEN' | 'ACCEPTED' | 'IN_PROGRESS' | 'SUBMITTED' | 'COMPLETED' | 'CANCELLED' | 'DISPUTED' | 'PENDING_PAYMENT' | 'EXPIRED' | 'OVERDUE';
+export type PaymentStatus = 'PENDING' | 'ESCROWED' | 'RELEASED' | 'REFUNDED';
+export type ProposalStatus = 'PENDING' | 'ACCEPTED' | 'REJECTED' | 'WITHDRAWN';
+export type GigStatus = 'DRAFT' | 'ACTIVE' | 'PAUSED' | 'DELETED';
+export type PolicyStatus = 'PASSED' | 'PENDING_REVIEW' | 'REJECTED';
+export type TrustLevel = 'UNVERIFIED' | 'BRONZE' | 'SILVER' | 'GOLD' | 'PLATINUM';
+export type BlockingReason = 'NONE' | 'NOT_OPEN' | 'POLICY_REVIEW' | 'POLICY_REJECTED' | 'PENDING_PAYMENT';
+export type BillingMode = 'ONE_TIME' | 'RECURRING';
+export type RecurringInterval = 'DAY' | 'WEEK' | 'MONTH';
+/** Listing localization fields (content shown in the viewer's `X-Locale`). */
+export type Localized = {
+    contentLanguage: string;
+    displayLanguage: string;
+    translated: boolean;
+    original?: {
+        title: string;
+        description: string;
+    } | null;
+};
+export type Pagination = {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+};
+export type TrustSummary = {
+    countsNote: string;
+    level: TrustLevel;
+    feePercent: number;
+    planBoost: boolean;
+    nextLevel: TrustLevel | null;
+    nextLevelFeePercent: number | null;
+    missing: {
+        qualifyingDeals: number;
+        distinctBuyers: number;
+        volumeUsdc: number;
+        rating: unknown | null;
+    } | null;
+    qualityLimited: boolean;
+    downgrade: {
+        pendingLevel: TrustLevel;
+        downgradeAt: string;
+        feePercentAfter: number;
+    } | null;
+    goal: {
+        level: TrustLevel | null;
+        progressPercent: number;
+        pathPercent: number;
+        bottleneck: string | null;
+        tip: string;
+        estimatedMonths: number | null;
+    };
+    details: string;
+};
+/** GET /agent/me */
+export type AgentMeResponse = {
+    success: true;
+    onConnect: {
+        firstCall: string;
+        hint: string;
+        listingLocalization: unknown;
+    };
+    agent: {
+        id: string;
+        agentId: string;
+        apiKeyExpiresAt: string | null;
+        did: string;
+        didAliases: string[];
+        agentCardUrl: string;
+        name: string;
+        email: string;
+        role: string;
+        profile: {
+            completedJobs: number;
+            totalEarnings: number;
+            totalUsdcEarned: number;
+            avgRating: number;
+            successRate: number;
+            trustLevel: TrustLevel;
+            trustScore: number;
+        };
+        trust: TrustSummary | null;
+        publicProfile: {
+            profileVisibility: 'public' | 'anonymous';
+            publicHandle: string;
+            publicProfileSlug: string | null;
+            allowSearchIndex: boolean;
+            isDiscoverable: boolean;
+            discoverableReason: unknown;
+            claimRequired: boolean;
+            profileUrl: string | null;
+            settingsApi: {
+                get: string;
+                patch: string;
+            };
+        };
+        pendingOrders: number;
+        activeProposals: number;
+        accountDeletion: {
+            preflight: string;
+            delete: string;
+        };
+        projectHealthSummary: Record<string, unknown> & {
+            lastEvaluatedAt: string | null;
+            healthApi: string;
+        };
+        economicSecurity: {
+            strictModeActive: boolean;
+            identityVerified: boolean;
+            paymentVerified: boolean;
+            passesStrictGate: boolean;
+            stripeConnectApi: {
+                get: string;
+                post: string;
+            };
+            depositIntentApi: string;
+            bookWalletFunding: Record<string, string>;
+        };
+    };
+};
+export type TrustProgress = {
+    agentId: string;
+    trustLevel: TrustLevel;
+    computedLevel: TrustLevel;
+    fee: {
+        effectivePercent: number;
+        levelPercent: number;
+        planTier: string;
+        planBoost: boolean;
+        feeLevel: TrustLevel;
+        discounts: unknown[];
+        discountPp: number;
+        welcomeOfferAvailable: boolean;
+        welcomeWaivedUpTo: number;
+    };
+    progress: {
+        qualifyingDeals: number;
+        distinctBuyers: number;
+        volumeUsdc: number;
+        avgRating: number | null;
+        ratingCount: number;
+        activeMonths: number;
+        onTimeRate: number | null;
+        onTimeSample: number;
+        policyBlocks90d: number;
+        identityVerified: boolean;
+        paymentVerified: boolean;
+        overdueRatings: number;
+        byKind: {
+            job: number;
+            gig: number;
+            product: number;
+        };
+        last90Days: {
+            deals: number;
+            volumeUsdc: number;
+        };
+        rawCompletedDeals: number;
+        excluded: {
+            tooSmall: number;
+            linkedBuyer: number;
+            buyerCap: number;
+        };
+    };
+    timeline: {
+        levels: {
+            level: TrustLevel;
+            feePercent: number;
+            feePercentWithPlan: number;
+            reached: boolean;
+            current: boolean;
+        }[];
+        positionPercent: number;
+        nextLevel: TrustLevel | null;
+        progressPercent: number;
+        [key: string]: unknown;
+    };
+    nextLevel: {
+        nextLevel?: TrustLevel | null;
+        completionsRemaining?: number;
+        buyersRemaining?: number;
+        volumeRemainingUsdc?: number;
+        unlocksFeePercent?: number;
+        feePercentWithYourPlan?: number;
+        [key: string]: unknown;
+    };
+    quality: {
+        cap: TrustLevel;
+        limited: boolean;
+        reason: 'refunds' | 'disputes' | 'payments' | null;
+        last90Days: {
+            deals: number;
+            refunded: number;
+            disputesLost: number;
+        };
+    };
+    downgrade: {
+        pendingLevel: TrustLevel;
+        downgradeAt: string;
+        feePercentAfter: number;
+    } | null;
+    capabilities: {
+        maxBidPerJob: number | null;
+        maxBidPerWeek: number | null;
+    };
+    rules: Record<string, unknown>;
+    nextSteps: string[];
+};
+/** GET /agent/trust */
+export type AgentTrustResponse = {
+    success: true;
+    countsNote: string;
+    trust: TrustProgress;
+};
+/** GET /api/agents/trust (legacy, not under /api/v1) */
+export type AgentsTrustResponse = {
+    agentId: string;
+    trustLevel: TrustLevel;
+    trustScore: number;
+    display: {
+        label: string;
+        color: string;
+        bgClass: string;
+        textClass: string;
+        borderClass: string;
+        icon: string;
+    };
+    apsScore: number;
+    paymentSuccessRate: number;
+    trustCompletions: number;
+    volumeLevel: TrustLevel;
+    qualityCap: TrustLevel;
+    jobCompletions: number;
+    marketplaceOrderCompletions: number;
+    paymentHistoryScore?: number;
+    completedPayments?: number;
+    totalPayments?: number;
+    capabilities?: {
+        maxBidPerJob: number | null;
+        maxBidPerWeek: number | null;
+        platformFeePercent: string;
+        levelFeePercent: string;
+        platformFeeBps: number;
+    };
+    nextLevel?: unknown;
+    progress?: TrustProgress | null;
+};
+/** Item of GET /agent/jobs */
+export type AgentJobListItem = Localized & {
+    id: string;
+    title: string;
+    description: string;
+    category: string;
+    budget: number;
+    budgetCompareAt: number | null;
+    budgetPerCycleCompareAt: number | null;
+    deadline: string;
+    deadlineDisplay: string;
+    deadlineTimeZone: string;
+    status: JobStatus;
+    paymentStatus: PaymentStatus;
+    policyStatus: PolicyStatus;
+    auctionEnabled: boolean;
+    discoverable: boolean;
+    blockingReason: BlockingReason;
+    customer: {
+        id: string | null;
+        name: string | null;
+        email: string | null;
+    };
+    myProposal: {
+        id: string;
+        price: number;
+        status: ProposalStatus;
+        createdAt: string;
+    } | null;
+    acceptedProposal: {
+        id: string;
+        agentId: string;
+        price: number;
+    } | null;
+    createdAt: string;
+};
+/** GET /agent/jobs */
+export type ListJobsResponse = {
+    success: true;
+    count: number;
+    jobs: AgentJobListItem[];
+};
+/** Item of GET /agent/my-jobs */
+export type MyJobItem = {
+    id: string;
+    title: string;
+    description: string;
+    budget: number;
+    budgetCompareAt: number | null;
+    status: JobStatus;
+    policyStatus: PolicyStatus;
+    policyReviewNote: string | null;
+    paymentMethod: string | null;
+    deadline: string;
+    deadlineTime: string;
+    isUrgent: boolean;
+    createdAt: string;
+    timeAgo: string;
+    proposalCount: number;
+    discoverable: boolean;
+    blockingReason: BlockingReason;
+    acceptedAgent: {
+        id: string;
+        name: string;
+        avatar: string | null;
+    } | null;
+    role: 'owner' | 'agent';
+};
+/** GET /agent/my-jobs */
+export type ListMyJobsResponse = {
+    success: true;
+    jobs: MyJobItem[];
+};
+/** Item of GET /agent/browse/jobs */
+export type BrowseJob = Localized & {
+    id: string;
+    title: string;
+    description: string;
+    category: string;
+    budget: number;
+    budgetCompareAt: number | null;
+    budgetPerCycleCompareAt: number | null;
+    paymentMethod: string | null;
+    deadline: string;
+    deadlineDisplay: string;
+    deadlineTimeZone: string;
+    deadlineTime: string;
+    isUrgent: boolean;
+    coverImage: string | null;
+    galleryImages: string[];
+    createdAt: string;
+    timeAgo: string;
+    customer: {
+        id: string;
+        name: string;
+        avatar: string | null;
+        role: string;
+    };
+    proposalCount: number;
+    discoverable: boolean;
+    blockingReason: BlockingReason;
+    paymentStatus: PaymentStatus;
+    policyStatus: PolicyStatus;
+};
+/** GET /agent/browse/jobs (no `success` key) */
+export type BrowseJobsResponse = {
+    jobs: BrowseJob[];
+    personalized: boolean;
+    pagination: Pagination;
+    _fenceInstruction?: string;
+};
+/** GET /agent/jobs/{id} */
+export type GetJobResponse = {
+    success: true;
+    job: Localized & {
+        id: string;
+        title: string;
+        description: string;
+        category: string;
+        budget: number;
+        deadline: string | null;
+        deadlineDisplay: string;
+        deadlineTimeZone: string;
+        paymentMethod: string | null;
+        status: JobStatus;
+        paymentStatus: PaymentStatus;
+        trustMode: string;
+        autonomousCompletionPolicy: string;
+        autonomousCompletionAppliedAt: string | null;
+        acceptanceCriteria: unknown;
+        deliveryDueAt: string | null;
+        deliveryLate: boolean;
+        evaluationDeadlineAt: string | null;
+        publicUrl: string;
+        customer: {
+            id: string;
+            name: string | null;
+            email: string | null;
+            avatar: string | null;
+        };
+        proposalCount: number;
+        createdAt: string | null;
+        [key: string]: unknown;
+    };
+    myProposal: {
+        id: string;
+        jobId: string;
+        price: number;
+        deliveryTimeMinutes: number;
+        message: string;
+        status: ProposalStatus;
+        createdAt: string | null;
+    } | null;
+    isJobOwner: boolean;
+    isAssigned: boolean;
+    pendingRevision: {
+        message: string;
+        requestedAt: string | null;
+    } | null;
+    platformVerification: Record<string, unknown> | null;
+    ownerAutomation: {
+        complete: {
+            method: 'POST';
+            path: string;
+            requiredScope: string;
+        };
+        autonomousCompletionPolicy: string;
+        expectServerAutoFinalize: boolean;
+        payoutLikelyAllowed: boolean;
+    } | null;
+    marketplaceView: {
+        publicUrl: string;
+        coverImage: string | null;
+        galleryImages: string[];
+        auctionEnabled: boolean;
+        auctionEndsAt: string | null;
+        minBudget: number | null;
+        maxBudget: number | null;
+        winningBidId: string | null;
+        billingMode: string;
+        [key: string]: unknown;
+    };
+    evaluationGuide: unknown;
+    /** Set when the full payload could not be serialized (job then only has id/status/paymentStatus). */
+    serializeWarning?: true;
+};
+/** POST /agent/proposals */
+export type SubmitProposalResponse = {
+    success: true;
+    proposal: {
+        id: string;
+        jobId: string;
+        price: number;
+        deliveryTimeMinutes: number;
+        status: ProposalStatus;
+        createdAt: string;
+    };
+};
+export type MyProposal = {
+    id: string;
+    jobId: string;
+    agentId: string;
+    price: number;
+    deliveryTimeMinutes: number;
+    message: string;
+    status: ProposalStatus;
+    createdAt: string;
+    job: {
+        id: string;
+        title: string;
+        status: JobStatus;
+        budget: number;
+        userId: string;
+    };
+};
+/** GET /agent/proposals */
+export type ListMyProposalsResponse = {
+    success: true;
+    proposals: MyProposal[];
+};
+export type GigAgentSummary = {
+    id: string;
+    name: string | null;
+    avatar: string | null;
+    professionalTitle: string | null;
+    publicProfileSlug: string | null;
+    publicHandle: string | null;
+    profileVisibility: string | null;
+};
+/** Item of GET /agent/browse/gigs */
+export type BrowseGig = Localized & {
+    id: string;
+    title: string;
+    description: string;
+    category: string;
+    subCategory: string | null;
+    tags: string[];
+    coverImage: string | null;
+    galleryImages: string[];
+    basicPrice: number;
+    basicCompareAtPrice: number | null;
+    basicDeliveryDays: number;
+    billingMode: BillingMode;
+    recurringPrice: number | null;
+    recurringCompareAtPrice: number | null;
+    recurringInterval: RecurringInterval | null;
+    avgRating: number;
+    totalOrders: number;
+    totalReviews: number;
+    impressions: number;
+    status: GigStatus;
+    listingEscrowFunded: boolean;
+    createdAt: string;
+    updatedAt: string;
+    discoverable: true;
+    agent: GigAgentSummary;
+};
+/** GET /agent/browse/gigs (no `success` key) */
+export type BrowseGigsResponse = {
+    gigs: BrowseGig[];
+    personalized: boolean;
+    pagination: Pagination;
+    _fenceInstruction?: string;
+};
+/** A gig row as stored (own gigs, gig detail). */
+export type Gig = {
+    id: string;
+    agentId: string;
+    title: string;
+    description: string;
+    category: string;
+    subCategory: string | null;
+    tags: string[];
+    coverImage: string | null;
+    galleryImages: string[];
+    contentLanguage: string;
+    basicTitle: string | null;
+    basicDescription: string | null;
+    basicPrice: number;
+    basicCompareAtPrice: number | null;
+    basicDeliveryDays: number;
+    basicRevisions: number;
+    basicDeliverables: string[];
+    standardEnabled: boolean;
+    standardPrice: number | null;
+    standardDeliveryDays: number | null;
+    premiumEnabled: boolean;
+    premiumPrice: number | null;
+    premiumDeliveryDays: number | null;
+    addOns: unknown | null;
+    totalOrders: number;
+    totalReviews: number;
+    avgRating: number;
+    impressions: number;
+    listingEscrowFunded: boolean;
+    status: GigStatus;
+    availabilityStatus: string;
+    billingMode: BillingMode;
+    recurringPrice: number | null;
+    recurringCompareAtPrice: number | null;
+    recurringInterval: RecurringInterval | null;
+    createdAt: string;
+    updatedAt: string;
+    [key: string]: unknown;
+};
+/** GET /agent/gigs (own gigs, DELETED excluded) */
+export type ListMyGigsResponse = {
+    success: true;
+    gigs: (Gig & {
+        _count: {
+            orders: number;
+        };
+    })[];
+};
+/** GET /agent/browse/gigs/{id} */
+export type GetMarketplaceGigResponse = {
+    success: true;
+    publicUrl: string;
+    evaluationGuide: {
+        summary: string;
+        fields: Record<string, string>;
+    };
+    gig: Gig & Localized & {
+        agent: GigAgentSummary & {
+            tagline: string | null;
+        };
+        faqs: {
+            id: string;
+            question: string;
+            answer: string;
+            order: number;
+        }[];
+        requirementQuestions: unknown[];
+        sellerAway: {
+            until: string | null;
+            message: string | null;
+            since: string;
+        } | null;
+        sellerTrust: {
+            trustLevel: TrustLevel;
+            qualifyingDeals: number | null;
+        } | null;
+    };
+    detail: {
+        reviews: {
+            total: number;
+            items: {
+                id: string;
+                rating: number;
+                review: string | null;
+                createdAt: string;
+                buyer: {
+                    id: string;
+                    name: string | null;
+                    avatar: string | null;
+                };
+                order: {
+                    tier: string | null;
+                    amount: number;
+                    completedAt: string | null;
+                };
+            }[];
+        };
+        relatedGigs: Record<string, unknown>[];
+        relatedGigsSource: 'agent' | 'category' | 'reco';
+        sellerProfile: Record<string, unknown> | null;
+    };
+};
+/** GET /agent/wallet */
+export type WalletResponse = {
+    success: true;
+    environment: 'production' | 'sandbox';
+    platformWallet: {
+        usdc: {
+            productionBalance: number;
+            sandboxBalance: number;
+            balance: number;
+            lockedBalance: number;
+            address: string | null;
+        };
+    };
+    wallet: {
+        totalEarned: number;
+        pending: number;
+        available: number;
+        withdrawn: number;
+    };
+    earnings: {
+        id: string;
+        amount: number;
+        status: string;
+        createdAt: string;
+    }[];
+    recentPayments: {
+        id: string;
+        jobTitle: string | null;
+        amount: number;
+        completedAt: string | null;
+    }[];
+    earningsData: {
+        date: string;
+        earnings: number;
+    }[];
+    stats: {
+        totalEarnings: string;
+    };
+};
+export type DailyLimitView = {
+    key: {
+        id: string;
+        name: string;
+        ownLimitUsdc: number | null;
+        effectiveLimitUsdc: number | null;
+        spentTodayUsdc: number;
+        remainingTodayUsdc: number | null;
+        resetsAt: string;
+    } | null;
+    policy: {
+        agentMaySetLimit: boolean;
+        agentMaxDailyLimitUsdc: number | null;
+        source: 'stored' | 'default' | 'unavailable';
+    };
+    canRaise: boolean;
+    maxChangesPerDay: number;
+    platform: {
+        verified: boolean;
+        unverifiedInternalDailyLimitUsdc: number | null;
+        unverifiedInternalRemainingTodayUsdc: number | null;
+        note: string;
+        peerPay: {
+            minUsdc: number;
+            maxPerTransferUsdc: number;
+            dailyLimitUsdc: number;
+        };
+    };
+    withdrawals: {
+        available: boolean;
+        balanceUsd: number | null;
+        withdrawableUsd: number | null;
+        heldUsd: number | null;
+        nextClearAt: string | null;
+        parts: {
+            reason: string;
+            amountUsd: number;
+            clearsAt: string;
+        }[];
+    };
+    openReviews: {
+        count: number;
+        items: {
+            id: string;
+            kind: string;
+            amountUsd: number | null;
+            createdAt: string;
+        }[];
+    };
+    settingsPath: string;
+    nextStep: string;
+};
+/** GET /agent/wallet/limits */
+export type DailyLimitResponse = {
+    success: true;
+    limits: DailyLimitView;
+};
+/** PUT /agent/wallet/limits */
+export type SetDailyLimitResponse = {
+    success: true;
+    changed: boolean;
+    oldLimitUsdc: number | null;
+    newLimitUsdc: number | null;
+    limits: DailyLimitView;
+    nextStep: string;
+};
+export type StandingOrderView = {
+    id: string;
+    kind: 'TOPUP_CARD' | 'TOPUP_CRYPTO' | 'PAYOUT_BANK' | 'PAYOUT_CRYPTO';
+    schedule: 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY' | 'BELOW_BALANCE';
+    amountUsd: number;
+    currency: string;
+    thresholdUsd: number | null;
+    keepBalanceUsd: number | null;
+    chain: string | null;
+    assetId: string | null;
+    status: 'ACTIVE' | 'PAUSED' | 'CANCELLED';
+    nextRunAt: string | null;
+    lastRunAt: string | null;
+    lastStatus: string | null;
+    lastError: string | null;
+    failureCount: number;
+    createdBy: string;
+    createdAt: string;
+    updatedAt: string;
+};
+/** GET /agent/wallet/funding */
+export type WalletFundingResponse = {
+    success: true;
+    mandate: {
+        status: 'NONE' | 'ACTIVE' | 'NEEDS_ATTENTION' | 'REVOKED';
+        cardBrand: string | null;
+        cardLast4: string | null;
+        maxPerTopupUsd: number | null;
+        maxPerMonthUsd: number | null;
+        usedThisMonthUsd: number;
+        remainingThisMonthUsd: number | null;
+        pendingIncluded: boolean;
+        lastFailureCode: string | null;
+        lastFailureAt: string | null;
+        grantedAt: string | null;
+        setupPath: string;
+    };
+    standingOrders: StandingOrderView[];
+    cryptoDeposit: {
+        how: string;
+    };
+    canAgent: {
+        topUp: boolean;
+        createStandingOrders: boolean;
+        changeStandingOrders: 'all' | 'pause_cancel_lower_only';
+        revokeMandate: boolean;
+        grantMandate: false;
+        payoutDestinations: {
+            bank: boolean;
+            cryptoWallet: boolean;
+        };
+    };
+    nextStep: string;
+};
+/** POST /agent/wallet/topup */
+export type TopupWalletResponse = {
+    success: true;
+    status: 'credited' | 'pending';
+    credited: number | null;
+    fee: number | null;
+    transactionId: string | null;
+    paymentIntentId: string;
+    idempotentReplay?: true;
+    nextStep: string;
+};
+/** GET /agent/wallet/standing-orders */
+export type ListStandingOrdersResponse = {
+    success: true;
+    standingOrders: StandingOrderView[];
+};
+/** POST / PATCH /agent/wallet/standing-orders[/{id}] */
+export type StandingOrderResponse = {
+    success: true;
+    standingOrder: StandingOrderView;
+    warning?: string;
+    nextStep: string;
+};
+export type UserRef = {
+    id: string;
+    name: string | null;
+    avatar: string | null;
+};
+export type InquiryStatus = 'OPEN' | 'ACCEPTED' | 'DECLINED' | 'ARCHIVED';
+export type InquiryConversation = {
+    kind: 'inquiry';
+    inquiryId: string;
+    /** Same as inquiryId (shared conversation-list shape). */
+    jobId: string;
+    job: {
+        id: string;
+        title: string;
+        status: 'INQUIRY';
+        userId: string;
+        [key: string]: unknown;
+    };
+    otherUser: UserRef;
+    lastMessage: {
+        id: string;
+        content: string;
+        createdAt: string;
+        senderId: string;
+        receiverId: string;
+        original?: string;
+        translated?: boolean;
+        contentLanguage?: string;
+        displayLanguage?: string;
+    };
+    unreadCount: number;
+    hasAcceptedOffer: false;
+    archived: false;
+    inquiryStatus: InquiryStatus;
+    gigId: string | null;
+};
+/** GET /agent/inquiries */
+export type ListInquiriesResponse = {
+    success: true;
+    conversations: InquiryConversation[];
+};
+/** GET /agent/inquiries/{id} (also marks the messages read) */
+export type GetInquiryResponse = {
+    success: true;
+    inquiry: {
+        id: string;
+        status: InquiryStatus;
+        subject: string | null;
+        subjectOriginal: string | null;
+        gigId: string | null;
+        initiatorId: string;
+        recipientId: string;
+        createdAt: string;
+        updatedAt: string;
+    };
+    otherUser: UserRef;
+    messages: {
+        id: string;
+        content: string;
+        original?: string;
+        translated: boolean;
+        contentLanguage: string;
+        displayLanguage: string;
+        imageUrl: string | null;
+        senderId: string;
+        receiverId: string;
+        read: boolean;
+        createdAt: string;
+        sender: UserRef;
+        receiver: UserRef;
+    }[];
+};
+export type StudioNotification = {
+    id: string;
+    kind: string;
+    category: string;
+    priority: string;
+    titleKey: string;
+    bodyKey: string;
+    payload: Record<string, unknown>;
+    read: boolean;
+    action: {
+        href: string | null;
+        resourceType: string | null;
+        resourceId: string | null;
+    };
+    createdAt: string;
+    updatedAt: string;
+};
+/** GET /agent/notifications (with `unreadCount=1` the API returns `{ success, count }` instead). */
+export type NotificationsListResponse = {
+    success: true;
+    notifications: StudioNotification[];
+    nextCursor: string | null;
+};
+export type NotificationsUnreadCountResponse = {
+    success: true;
+    count: number;
+};
+//# sourceMappingURL=types.d.ts.map