@flashbacktech/tsclient 0.4.54 → 0.4.55

package/dist/index.d.cts

@@ -120,6 +120,8 @@ interface RegisterRequest {
     isBusiness?: boolean;
     activationUid?: string;
     activationToken?: string;
+    /** Optional referral/reseller code applied to the new org at signup. */
+    referralCode?: string;
 }
 interface ActivateRequest {
     uid: string;
@@ -301,6 +303,16 @@ interface Organization {
      * ADMIN_ORGANIZATION env var).
      */
     isAdmin?: boolean;
+    /** Admin-designated reseller. Unlocks the /reseller surface. */
+    isReseller?: boolean;
+    /** Per-reseller commission override in bps; null => global default. */
+    resellerCommissionBps?: number | null;
+    /** Set when this org redeemed a reseller's code; null => not from a reseller. */
+    resellerOrgId?: string | null;
+    /** ISO 8601 timestamp the reseller association was established. */
+    resellerAssociatedAt?: string | null;
+    /** ISO 8601 timestamp an admin ended the association; null => active. */
+    resellerDetachedAt?: string | null;
 }
 interface UpdateOrganizationRequest {
     name?: string;
@@ -2294,6 +2306,182 @@ declare class BudgetsClient {
     updateScheduleCostLimit(scheduleId: string, body: UpdateCostLimitRequest): Promise<unknown>;
 }
 
+/** A redeemable referral code minted by an org (multiple, named per campaign). */
+interface ReferralCode {
+    id: string;
+    orgId: string;
+    code: string;
+    label?: string | null;
+    isActive: boolean;
+    createdAt: string;
+    deletedAt?: string | null;
+    /** Per-code stats (populated by listCodes). */
+    redeemedCount: number;
+    qualifiedCount: number;
+}
+/** Attribution row + snapshotted terms for a referred org. */
+interface ReferralRedemption {
+    id: string;
+    codeId: string;
+    referrerOrgId: string;
+    referredOrgId: string;
+    configId?: string | null;
+    isResellerCode: boolean;
+    lockedReferrerRewardMicros: number;
+    lockedReferredWelcomeMicros: number;
+    lockedThresholdMicros: number;
+    status: 'pending' | 'paid' | 'void';
+    qualifiedAt?: string | null;
+    referrerGrantTxId?: string | null;
+    referredGrantTxId?: string | null;
+    redeemedAt: string;
+}
+/** Caller org's referral summary as referrer. */
+interface ReferralStats {
+    redeemedCount: number;
+    qualifiedCount: number;
+    totalCreditsEarnedMicros: number;
+}
+interface MintReferralCodeRequest {
+    label?: string;
+}
+interface RedeemReferralCodeRequest {
+    code: string;
+}
+
+/**
+ * Org self-service referrals. Any org can mint codes and redeem one (subject
+ * to server-side guards: never-attributed, not reseller-associated, and
+ * pre-first-purchase). Two-sided credits fire once the referred org's
+ * cumulative spend reaches the snapshotted threshold.
+ */
+declare class ReferralsClient {
+    private readonly http;
+    constructor(http: BaseClient);
+    /** Mint a new referral code for the caller's org. */
+    mintCode(body?: MintReferralCodeRequest): Promise<ReferralCode>;
+    /** List the caller org's codes with per-code redeemed/qualified counts. */
+    listCodes(): Promise<ReferralCode[]>;
+    /** Activate or deactivate one of the caller org's codes. */
+    setCodeActive(codeId: string, isActive: boolean): Promise<ReferralCode>;
+    /** Caller org's referral summary as referrer (redemptions, qualified, credits earned). */
+    stats(): Promise<ReferralStats>;
+    /**
+     * Redeem a referral code for the caller's org. Fails (4xx with an
+     * `error_code`) when a guard rejects it: `code_inactive`, `self_referral`,
+     * `already_redeemed`, `already_associated`, or `has_purchases`.
+     */
+    redeem(body: RedeemReferralCodeRequest): Promise<ReferralRedemption>;
+}
+
+/** One org associated to a reseller, with gross + commission rollups. */
+interface AssociatedOrg {
+    orgId: string;
+    orgName: string;
+    associatedAt?: string | null;
+    detachedAt?: string | null;
+    grossPurchasedMicros: number;
+    commissionAccruedMicros: number;
+    commissionPaidMicros: number;
+}
+/** One cash-commission accrual row. */
+interface ResellerCommission {
+    id: string;
+    resellerOrgId: string;
+    associatedOrgId: string;
+    paymentId: string;
+    grossAmountMicros: number;
+    commissionBps: number;
+    commissionAmountMicros: number;
+    status: 'accrued' | 'paid' | 'void';
+    payoutId?: string | null;
+    accruedAt: string;
+}
+/** One monthly payout (batch computes; money movement is ops). */
+interface ResellerPayout {
+    id: string;
+    resellerOrgId: string;
+    periodStart: string;
+    periodEnd: string;
+    totalAmountMicros: number;
+    status: 'draft' | 'approved' | 'paid';
+    externalRef?: string | null;
+    createdAt: string;
+    paidAt?: string | null;
+}
+/** A reseller org plus aggregate performance (admin list). */
+interface ResellerPerformance extends Organization {
+    associatedOrgCount: number;
+    commissionAccruedMicros: number;
+    commissionPaidMicros: number;
+}
+/** One row of the time-journaled billing-program parameters. */
+interface BillingProgramConfig {
+    id: string;
+    validFrom: string;
+    validTo?: string | null;
+    referrerRewardMicros: number;
+    referredWelcomeMicros: number;
+    referralThresholdMicros: number;
+    defaultResellerCommissionBps: number;
+    createdAt: string;
+    createdBy?: string | null;
+    note?: string | null;
+}
+interface SetResellerRequest {
+    /** Per-reseller commission override in bps; omit to use the global default. */
+    commissionBps?: number;
+}
+interface AppendProgramConfigRequest {
+    referrerRewardMicros: number;
+    referredWelcomeMicros: number;
+    referralThresholdMicros: number;
+    defaultResellerCommissionBps: number;
+    note?: string;
+}
+interface GeneratePayoutsRequest {
+    /** Inclusive period start, YYYY-MM-DD. */
+    periodStart: string;
+    /** Exclusive period end, YYYY-MM-DD. */
+    periodEnd: string;
+}
+interface UpdatePayoutRequest {
+    status: 'draft' | 'approved' | 'paid';
+    externalRef?: string;
+}
+
+/**
+ * Reseller surface. The first three methods are self-service for an org with
+ * `isReseller === true` (the server gates on it). The remaining methods are
+ * platform-admin only (gated on the caller's home org being the admin org).
+ */
+declare class ResellerClient {
+    private readonly http;
+    constructor(http: BaseClient);
+    /** Orgs associated to the caller reseller, with gross + commission rollups. */
+    listAssociatedOrgs(): Promise<AssociatedOrg[]>;
+    /** The caller reseller's commission ledger. */
+    listCommissions(): Promise<ResellerCommission[]>;
+    /** The caller reseller's payout history. */
+    listPayouts(): Promise<ResellerPayout[]>;
+    /** List all reseller orgs with aggregate performance. */
+    listResellers(): Promise<ResellerPerformance[]>;
+    /** Designate an org as a reseller (optionally with a per-reseller bps override). */
+    setReseller(orgId: string, body?: SetResellerRequest): Promise<Organization>;
+    /** Revoke an org's reseller status. */
+    revokeReseller(orgId: string): Promise<Organization>;
+    /** End an org's reseller association (stamps resellerDetachedAt). */
+    detachAssociation(orgId: string): Promise<Organization>;
+    /** The billing-program-config journal, newest first. */
+    getProgramConfig(): Promise<BillingProgramConfig[]>;
+    /** Append a new program-config period (closes the prior open row). */
+    appendProgramConfig(body: AppendProgramConfigRequest): Promise<BillingProgramConfig>;
+    /** Draft payouts from accrued commissions in the given period. */
+    generatePayouts(body: GeneratePayoutsRequest): Promise<ResellerPayout[]>;
+    /** Approve or mark-paid a payout (and optionally record an external ref). */
+    updatePayout(payoutId: string, body: UpdatePayoutRequest): Promise<ResellerPayout>;
+}
+
 type CloudAgentClientOptions = BaseClientOptions;
 declare class AgentEngineFacade {
     readonly templates: TemplatesClient;
@@ -2321,6 +2509,8 @@ declare class CloudAgentClient {
     readonly billing: BillingFacade;
     readonly usage: UsageClient;
     readonly budgets: BudgetsClient;
+    readonly referrals: ReferralsClient;
+    readonly reseller: ResellerClient;
     constructor(options: CloudAgentClientOptions);
 }
 
@@ -2335,4 +2525,4 @@ declare class NotImplementedError extends Error {
     constructor(method: string);
 }
 
-export { type AcceptInviteRequest, AccessType, type AcquireScanLeaseRequest, type AcquireScanLeaseResponse, type ActionCategory, type ActivateRequest, type AddMemberRequest, type AddUserToOrgRequest, type AddUserToOrgResult, type AdjustOrgCreditsRequest, type AdjustOrgCreditsResult, type AnswerChatQuestionRequest, type AnswerChatQuestionResponse, type AuthUser, BaseClient, type BaseClientOptions, type BudgetScope, BudgetsClient, type BuyCreditPackRequest, type BuyCreditPackResponse, type BuyCustomCreditRequest, type BuyCustomCreditResponse, type BuySubscriptionRequest, type BuySubscriptionResponse, CAP_AI, CAP_COMPUTE, CAP_GENERAL, CAP_NOTIFY, CAP_STORAGE, CAP_VCS, type CancelChatTurnResponse, type CancelSubscriptionResponse, type ChatAssistantMessagePayload, type ChatBillingRefuseCode, type ChatBillingRefuseError, type ChatBudget, type ChatCheckpointedPayload, type ChatCompactionFiredPayload, type ChatDonePayload, type ChatEvent, type ChatEventType, type ChatFeedback, type ChatFeedbackEnvelope, type ChatMessage, type ChatMessageKind, type ChatMessageRole, type ChatNarrationPayload, type ChatPhase, type ChatPhasePayload, type ChatPlanDraftPayload, type ChatQuestionPayload, type ChatSchedule, type ChatScheduleEnvelope, type ChatScheduleNotifyOn, type ChatScheduleRunStatus, type ChatScope, type ChatSession, type ChatSessionSource, type ChatSessionTitlePayload, type ChatStepEventPayload, type ChatStepProgressPayload, type ChatStreamHandle, type ChatToolCallConfirmationRequiredPayload, type ChatToolCallFinishedPayload, type ChatToolCallStartedPayload, type ChatTurnStatus, type ClarificationOption, CloudAgentClient, type CloudAgentClientOptions, type CloudResource, type CloudResourceContainerRef, type CloudResourceEdge, type CloudScanHistory, type CloudScanLease, type ConfirmChatToolCallRequest, type ConfirmChatToolCallResponse, type CreateAgentTemplateRequest, type CreateChatScheduleRequest, type CreateChatSessionRequest, type CreateChatSessionResponse, type CreateCredentialRequest, type CreateGatewayTokenRequest, type CreateGatewayTokenResponse, type CreateOrganizationUserRequest, type CreateProjectRequest, type CreateSandboxRequest, type CreateScheduledTaskRequest, type Credential, type CreditBalance, type CreditPack, type CreditTransaction, type CreditTransactionKind, type CreditTransactionType, type CustomCreditPurchaseConfig, type DebugPayload, type DebugReceipt, type EffectiveChatBudget, type ExchangeCodeRequest, type FieldSpec, type FieldType, type FineTuneParams, type GatewayToken, type GetChatSessionResponse, type GetUsageSummaryQuery, type GetUsageSummaryResponse, HttpError, type ImpersonationProvider, type InviteOrgRequest, type InviteOrgResult, type ListAgentTemplatesQuery, type ListAgentTemplatesResponse, type ListChatFeedbackResponse, type ListChatScheduleRunsResponse, type ListChatSchedulesResponse, type ListChatSessionsQuery, type ListChatSessionsResponse, type ListCredentialsQuery, type ListCreditsTransactionsQuery, type ListCreditsTransactionsResponse, type ListPaymentsResponse, type ListSandboxesQuery, type ListScanHistoryQuery, type ListScanHistoryResponse, type ListScheduledTasksQuery, type ListScheduledTasksResponse, type LoginRequest, type MFASetupResponse, type MFASimpleResponse, type MFAStatus, MFAType, type MFAVerifyLoginRequest, type MFAVerifyLoginResponse, type MFAVerifySetupRequest, type MagicLinkActivateRequest, type MagicLinkSendResponse, type ModeType, type MonthlyCreditStats, NotImplementedError, type NotifyChannelOption, type NotifyEventType, type NotifySubscription, type OpenChatStreamOptions, type OrgBudget, type OrgCreditBalance, type OrgNotifySubscriptions, OrgRoles, type OrgSubscription, type Organization, type OrganizationUser, PROVIDER_CATALOG, type Payment, type PeekScanLeaseResponse, type PostChatMessageRequest, type PostChatMessageResponse, type Project, type ProjectMember, type ProviderID, type ProviderSpec, ProviderType, type PublicConfig, type Query, type ReconcileScope, type ReconcileTuple, type RefreshRequest, type RegisterRequest, type RequestOptions, type ResetPasswordRequest, type ResourceTreeCategory, type ResourceTreeCredential, type ResourceTreeGrouping, type ResourceTreeResource, type ResourceTreeResponse, ResourcesClient, type Sandbox, type SandboxCredential, type ScanInProgressError, type ScheduledTask, type ScopedBudget, type SessionResponse, type SessionTokens, type SetOrgNotifySubscriptionsRequest, type SimpleAgentResponse, type SimpleKeysResponse, type SimpleOrgResponse, type SimpleResponse$2 as SimpleResponse, type StorageType, type SubgraphDirection, type SubgraphRequest, type SubgraphResponse, type SubmitChatFeedbackRequest, type Subscription, type SubscriptionCapability, type SubscriptionPeriod, type SystemEvent, type SystemEventQuery, type SystemEventQueryResponse, type SystemEventReadResponse, type Template, type TokenProvider, type UnauthorizedHandler, type UpdateChatBudgetRequest, type UpdateChatScheduleRequest, type UpdateCostLimitRequest, type UpdateCredentialRequest, type UpdateMemberRoleRequest, type UpdateOrgBudgetRequest, type UpdateOrgUserRequest, type UpdateOrganizationRequest, type UpdateProjectRequest, type UpdateSandboxRequest, type UpdateScopedBudgetRequest, type UpdateUserRequest, type UpdateUserResponse, type UsageBucket, type UsageByModelQuery, type UsageByModelResponse, type UsageByModelRow, type UsageCostSplit, type UsageReportQuery, type UsageReportResponse, type UsageSummary, type UsageSummaryQuery, type UsageSummaryResponse, type UsageTotals, type UsageWindow, type UserProfile, type UserSummary, computeDisplayHint, getProvider, getValueAt, isMetadataPath, isSecretPath, listProviders, metadataKey, setValueAt, usdMicros, validate };
+export { type AcceptInviteRequest, AccessType, type AcquireScanLeaseRequest, type AcquireScanLeaseResponse, type ActionCategory, type ActivateRequest, type AddMemberRequest, type AddUserToOrgRequest, type AddUserToOrgResult, type AdjustOrgCreditsRequest, type AdjustOrgCreditsResult, type AnswerChatQuestionRequest, type AnswerChatQuestionResponse, type AppendProgramConfigRequest, type AssociatedOrg, type AuthUser, BaseClient, type BaseClientOptions, type BillingProgramConfig, type BudgetScope, BudgetsClient, type BuyCreditPackRequest, type BuyCreditPackResponse, type BuyCustomCreditRequest, type BuyCustomCreditResponse, type BuySubscriptionRequest, type BuySubscriptionResponse, CAP_AI, CAP_COMPUTE, CAP_GENERAL, CAP_NOTIFY, CAP_STORAGE, CAP_VCS, type CancelChatTurnResponse, type CancelSubscriptionResponse, type ChatAssistantMessagePayload, type ChatBillingRefuseCode, type ChatBillingRefuseError, type ChatBudget, type ChatCheckpointedPayload, type ChatCompactionFiredPayload, type ChatDonePayload, type ChatEvent, type ChatEventType, type ChatFeedback, type ChatFeedbackEnvelope, type ChatMessage, type ChatMessageKind, type ChatMessageRole, type ChatNarrationPayload, type ChatPhase, type ChatPhasePayload, type ChatPlanDraftPayload, type ChatQuestionPayload, type ChatSchedule, type ChatScheduleEnvelope, type ChatScheduleNotifyOn, type ChatScheduleRunStatus, type ChatScope, type ChatSession, type ChatSessionSource, type ChatSessionTitlePayload, type ChatStepEventPayload, type ChatStepProgressPayload, type ChatStreamHandle, type ChatToolCallConfirmationRequiredPayload, type ChatToolCallFinishedPayload, type ChatToolCallStartedPayload, type ChatTurnStatus, type ClarificationOption, CloudAgentClient, type CloudAgentClientOptions, type CloudResource, type CloudResourceContainerRef, type CloudResourceEdge, type CloudScanHistory, type CloudScanLease, type ConfirmChatToolCallRequest, type ConfirmChatToolCallResponse, type CreateAgentTemplateRequest, type CreateChatScheduleRequest, type CreateChatSessionRequest, type CreateChatSessionResponse, type CreateCredentialRequest, type CreateGatewayTokenRequest, type CreateGatewayTokenResponse, type CreateOrganizationUserRequest, type CreateProjectRequest, type CreateSandboxRequest, type CreateScheduledTaskRequest, type Credential, type CreditBalance, type CreditPack, type CreditTransaction, type CreditTransactionKind, type CreditTransactionType, type CustomCreditPurchaseConfig, type DebugPayload, type DebugReceipt, type EffectiveChatBudget, type ExchangeCodeRequest, type FieldSpec, type FieldType, type FineTuneParams, type GatewayToken, type GeneratePayoutsRequest, type GetChatSessionResponse, type GetUsageSummaryQuery, type GetUsageSummaryResponse, HttpError, type ImpersonationProvider, type InviteOrgRequest, type InviteOrgResult, type ListAgentTemplatesQuery, type ListAgentTemplatesResponse, type ListChatFeedbackResponse, type ListChatScheduleRunsResponse, type ListChatSchedulesResponse, type ListChatSessionsQuery, type ListChatSessionsResponse, type ListCredentialsQuery, type ListCreditsTransactionsQuery, type ListCreditsTransactionsResponse, type ListPaymentsResponse, type ListSandboxesQuery, type ListScanHistoryQuery, type ListScanHistoryResponse, type ListScheduledTasksQuery, type ListScheduledTasksResponse, type LoginRequest, type MFASetupResponse, type MFASimpleResponse, type MFAStatus, MFAType, type MFAVerifyLoginRequest, type MFAVerifyLoginResponse, type MFAVerifySetupRequest, type MagicLinkActivateRequest, type MagicLinkSendResponse, type MintReferralCodeRequest, type ModeType, type MonthlyCreditStats, NotImplementedError, type NotifyChannelOption, type NotifyEventType, type NotifySubscription, type OpenChatStreamOptions, type OrgBudget, type OrgCreditBalance, type OrgNotifySubscriptions, OrgRoles, type OrgSubscription, type Organization, type OrganizationUser, PROVIDER_CATALOG, type Payment, type PeekScanLeaseResponse, type PostChatMessageRequest, type PostChatMessageResponse, type Project, type ProjectMember, type ProviderID, type ProviderSpec, ProviderType, type PublicConfig, type Query, type ReconcileScope, type ReconcileTuple, type RedeemReferralCodeRequest, type ReferralCode, type ReferralRedemption, type ReferralStats, ReferralsClient, type RefreshRequest, type RegisterRequest, type RequestOptions, ResellerClient, type ResellerCommission, type ResellerPayout, type ResellerPerformance, type ResetPasswordRequest, type ResourceTreeCategory, type ResourceTreeCredential, type ResourceTreeGrouping, type ResourceTreeResource, type ResourceTreeResponse, ResourcesClient, type Sandbox, type SandboxCredential, type ScanInProgressError, type ScheduledTask, type ScopedBudget, type SessionResponse, type SessionTokens, type SetOrgNotifySubscriptionsRequest, type SetResellerRequest, type SimpleAgentResponse, type SimpleKeysResponse, type SimpleOrgResponse, type SimpleResponse$2 as SimpleResponse, type StorageType, type SubgraphDirection, type SubgraphRequest, type SubgraphResponse, type SubmitChatFeedbackRequest, type Subscription, type SubscriptionCapability, type SubscriptionPeriod, type SystemEvent, type SystemEventQuery, type SystemEventQueryResponse, type SystemEventReadResponse, type Template, type TokenProvider, type UnauthorizedHandler, type UpdateChatBudgetRequest, type UpdateChatScheduleRequest, type UpdateCostLimitRequest, type UpdateCredentialRequest, type UpdateMemberRoleRequest, type UpdateOrgBudgetRequest, type UpdateOrgUserRequest, type UpdateOrganizationRequest, type UpdatePayoutRequest, type UpdateProjectRequest, type UpdateSandboxRequest, type UpdateScopedBudgetRequest, type UpdateUserRequest, type UpdateUserResponse, type UsageBucket, type UsageByModelQuery, type UsageByModelResponse, type UsageByModelRow, type UsageCostSplit, type UsageReportQuery, type UsageReportResponse, type UsageSummary, type UsageSummaryQuery, type UsageSummaryResponse, type UsageTotals, type UsageWindow, type UserProfile, type UserSummary, computeDisplayHint, getProvider, getValueAt, isMetadataPath, isSecretPath, listProviders, metadataKey, setValueAt, usdMicros, validate };

package/dist/index.d.ts

@@ -120,6 +120,8 @@ interface RegisterRequest {
     isBusiness?: boolean;
     activationUid?: string;
     activationToken?: string;
+    /** Optional referral/reseller code applied to the new org at signup. */
+    referralCode?: string;
 }
 interface ActivateRequest {
     uid: string;
@@ -301,6 +303,16 @@ interface Organization {
      * ADMIN_ORGANIZATION env var).
      */
     isAdmin?: boolean;
+    /** Admin-designated reseller. Unlocks the /reseller surface. */
+    isReseller?: boolean;
+    /** Per-reseller commission override in bps; null => global default. */
+    resellerCommissionBps?: number | null;
+    /** Set when this org redeemed a reseller's code; null => not from a reseller. */
+    resellerOrgId?: string | null;
+    /** ISO 8601 timestamp the reseller association was established. */
+    resellerAssociatedAt?: string | null;
+    /** ISO 8601 timestamp an admin ended the association; null => active. */
+    resellerDetachedAt?: string | null;
 }
 interface UpdateOrganizationRequest {
     name?: string;
@@ -2294,6 +2306,182 @@ declare class BudgetsClient {
     updateScheduleCostLimit(scheduleId: string, body: UpdateCostLimitRequest): Promise<unknown>;
 }
 
+/** A redeemable referral code minted by an org (multiple, named per campaign). */
+interface ReferralCode {
+    id: string;
+    orgId: string;
+    code: string;
+    label?: string | null;
+    isActive: boolean;
+    createdAt: string;
+    deletedAt?: string | null;
+    /** Per-code stats (populated by listCodes). */
+    redeemedCount: number;
+    qualifiedCount: number;
+}
+/** Attribution row + snapshotted terms for a referred org. */
+interface ReferralRedemption {
+    id: string;
+    codeId: string;
+    referrerOrgId: string;
+    referredOrgId: string;
+    configId?: string | null;
+    isResellerCode: boolean;
+    lockedReferrerRewardMicros: number;
+    lockedReferredWelcomeMicros: number;
+    lockedThresholdMicros: number;
+    status: 'pending' | 'paid' | 'void';
+    qualifiedAt?: string | null;
+    referrerGrantTxId?: string | null;
+    referredGrantTxId?: string | null;
+    redeemedAt: string;
+}
+/** Caller org's referral summary as referrer. */
+interface ReferralStats {
+    redeemedCount: number;
+    qualifiedCount: number;
+    totalCreditsEarnedMicros: number;
+}
+interface MintReferralCodeRequest {
+    label?: string;
+}
+interface RedeemReferralCodeRequest {
+    code: string;
+}
+
+/**
+ * Org self-service referrals. Any org can mint codes and redeem one (subject
+ * to server-side guards: never-attributed, not reseller-associated, and
+ * pre-first-purchase). Two-sided credits fire once the referred org's
+ * cumulative spend reaches the snapshotted threshold.
+ */
+declare class ReferralsClient {
+    private readonly http;
+    constructor(http: BaseClient);
+    /** Mint a new referral code for the caller's org. */
+    mintCode(body?: MintReferralCodeRequest): Promise<ReferralCode>;
+    /** List the caller org's codes with per-code redeemed/qualified counts. */
+    listCodes(): Promise<ReferralCode[]>;
+    /** Activate or deactivate one of the caller org's codes. */
+    setCodeActive(codeId: string, isActive: boolean): Promise<ReferralCode>;
+    /** Caller org's referral summary as referrer (redemptions, qualified, credits earned). */
+    stats(): Promise<ReferralStats>;
+    /**
+     * Redeem a referral code for the caller's org. Fails (4xx with an
+     * `error_code`) when a guard rejects it: `code_inactive`, `self_referral`,
+     * `already_redeemed`, `already_associated`, or `has_purchases`.
+     */
+    redeem(body: RedeemReferralCodeRequest): Promise<ReferralRedemption>;
+}
+
+/** One org associated to a reseller, with gross + commission rollups. */
+interface AssociatedOrg {
+    orgId: string;
+    orgName: string;
+    associatedAt?: string | null;
+    detachedAt?: string | null;
+    grossPurchasedMicros: number;
+    commissionAccruedMicros: number;
+    commissionPaidMicros: number;
+}
+/** One cash-commission accrual row. */
+interface ResellerCommission {
+    id: string;
+    resellerOrgId: string;
+    associatedOrgId: string;
+    paymentId: string;
+    grossAmountMicros: number;
+    commissionBps: number;
+    commissionAmountMicros: number;
+    status: 'accrued' | 'paid' | 'void';
+    payoutId?: string | null;
+    accruedAt: string;
+}
+/** One monthly payout (batch computes; money movement is ops). */
+interface ResellerPayout {
+    id: string;
+    resellerOrgId: string;
+    periodStart: string;
+    periodEnd: string;
+    totalAmountMicros: number;
+    status: 'draft' | 'approved' | 'paid';
+    externalRef?: string | null;
+    createdAt: string;
+    paidAt?: string | null;
+}
+/** A reseller org plus aggregate performance (admin list). */
+interface ResellerPerformance extends Organization {
+    associatedOrgCount: number;
+    commissionAccruedMicros: number;
+    commissionPaidMicros: number;
+}
+/** One row of the time-journaled billing-program parameters. */
+interface BillingProgramConfig {
+    id: string;
+    validFrom: string;
+    validTo?: string | null;
+    referrerRewardMicros: number;
+    referredWelcomeMicros: number;
+    referralThresholdMicros: number;
+    defaultResellerCommissionBps: number;
+    createdAt: string;
+    createdBy?: string | null;
+    note?: string | null;
+}
+interface SetResellerRequest {
+    /** Per-reseller commission override in bps; omit to use the global default. */
+    commissionBps?: number;
+}
+interface AppendProgramConfigRequest {
+    referrerRewardMicros: number;
+    referredWelcomeMicros: number;
+    referralThresholdMicros: number;
+    defaultResellerCommissionBps: number;
+    note?: string;
+}
+interface GeneratePayoutsRequest {
+    /** Inclusive period start, YYYY-MM-DD. */
+    periodStart: string;
+    /** Exclusive period end, YYYY-MM-DD. */
+    periodEnd: string;
+}
+interface UpdatePayoutRequest {
+    status: 'draft' | 'approved' | 'paid';
+    externalRef?: string;
+}
+
+/**
+ * Reseller surface. The first three methods are self-service for an org with
+ * `isReseller === true` (the server gates on it). The remaining methods are
+ * platform-admin only (gated on the caller's home org being the admin org).
+ */
+declare class ResellerClient {
+    private readonly http;
+    constructor(http: BaseClient);
+    /** Orgs associated to the caller reseller, with gross + commission rollups. */
+    listAssociatedOrgs(): Promise<AssociatedOrg[]>;
+    /** The caller reseller's commission ledger. */
+    listCommissions(): Promise<ResellerCommission[]>;
+    /** The caller reseller's payout history. */
+    listPayouts(): Promise<ResellerPayout[]>;
+    /** List all reseller orgs with aggregate performance. */
+    listResellers(): Promise<ResellerPerformance[]>;
+    /** Designate an org as a reseller (optionally with a per-reseller bps override). */
+    setReseller(orgId: string, body?: SetResellerRequest): Promise<Organization>;
+    /** Revoke an org's reseller status. */
+    revokeReseller(orgId: string): Promise<Organization>;
+    /** End an org's reseller association (stamps resellerDetachedAt). */
+    detachAssociation(orgId: string): Promise<Organization>;
+    /** The billing-program-config journal, newest first. */
+    getProgramConfig(): Promise<BillingProgramConfig[]>;
+    /** Append a new program-config period (closes the prior open row). */
+    appendProgramConfig(body: AppendProgramConfigRequest): Promise<BillingProgramConfig>;
+    /** Draft payouts from accrued commissions in the given period. */
+    generatePayouts(body: GeneratePayoutsRequest): Promise<ResellerPayout[]>;
+    /** Approve or mark-paid a payout (and optionally record an external ref). */
+    updatePayout(payoutId: string, body: UpdatePayoutRequest): Promise<ResellerPayout>;
+}
+
 type CloudAgentClientOptions = BaseClientOptions;
 declare class AgentEngineFacade {
     readonly templates: TemplatesClient;
@@ -2321,6 +2509,8 @@ declare class CloudAgentClient {
     readonly billing: BillingFacade;
     readonly usage: UsageClient;
     readonly budgets: BudgetsClient;
+    readonly referrals: ReferralsClient;
+    readonly reseller: ResellerClient;
     constructor(options: CloudAgentClientOptions);
 }
 
@@ -2335,4 +2525,4 @@ declare class NotImplementedError extends Error {
     constructor(method: string);
 }
 
-export { type AcceptInviteRequest, AccessType, type AcquireScanLeaseRequest, type AcquireScanLeaseResponse, type ActionCategory, type ActivateRequest, type AddMemberRequest, type AddUserToOrgRequest, type AddUserToOrgResult, type AdjustOrgCreditsRequest, type AdjustOrgCreditsResult, type AnswerChatQuestionRequest, type AnswerChatQuestionResponse, type AuthUser, BaseClient, type BaseClientOptions, type BudgetScope, BudgetsClient, type BuyCreditPackRequest, type BuyCreditPackResponse, type BuyCustomCreditRequest, type BuyCustomCreditResponse, type BuySubscriptionRequest, type BuySubscriptionResponse, CAP_AI, CAP_COMPUTE, CAP_GENERAL, CAP_NOTIFY, CAP_STORAGE, CAP_VCS, type CancelChatTurnResponse, type CancelSubscriptionResponse, type ChatAssistantMessagePayload, type ChatBillingRefuseCode, type ChatBillingRefuseError, type ChatBudget, type ChatCheckpointedPayload, type ChatCompactionFiredPayload, type ChatDonePayload, type ChatEvent, type ChatEventType, type ChatFeedback, type ChatFeedbackEnvelope, type ChatMessage, type ChatMessageKind, type ChatMessageRole, type ChatNarrationPayload, type ChatPhase, type ChatPhasePayload, type ChatPlanDraftPayload, type ChatQuestionPayload, type ChatSchedule, type ChatScheduleEnvelope, type ChatScheduleNotifyOn, type ChatScheduleRunStatus, type ChatScope, type ChatSession, type ChatSessionSource, type ChatSessionTitlePayload, type ChatStepEventPayload, type ChatStepProgressPayload, type ChatStreamHandle, type ChatToolCallConfirmationRequiredPayload, type ChatToolCallFinishedPayload, type ChatToolCallStartedPayload, type ChatTurnStatus, type ClarificationOption, CloudAgentClient, type CloudAgentClientOptions, type CloudResource, type CloudResourceContainerRef, type CloudResourceEdge, type CloudScanHistory, type CloudScanLease, type ConfirmChatToolCallRequest, type ConfirmChatToolCallResponse, type CreateAgentTemplateRequest, type CreateChatScheduleRequest, type CreateChatSessionRequest, type CreateChatSessionResponse, type CreateCredentialRequest, type CreateGatewayTokenRequest, type CreateGatewayTokenResponse, type CreateOrganizationUserRequest, type CreateProjectRequest, type CreateSandboxRequest, type CreateScheduledTaskRequest, type Credential, type CreditBalance, type CreditPack, type CreditTransaction, type CreditTransactionKind, type CreditTransactionType, type CustomCreditPurchaseConfig, type DebugPayload, type DebugReceipt, type EffectiveChatBudget, type ExchangeCodeRequest, type FieldSpec, type FieldType, type FineTuneParams, type GatewayToken, type GetChatSessionResponse, type GetUsageSummaryQuery, type GetUsageSummaryResponse, HttpError, type ImpersonationProvider, type InviteOrgRequest, type InviteOrgResult, type ListAgentTemplatesQuery, type ListAgentTemplatesResponse, type ListChatFeedbackResponse, type ListChatScheduleRunsResponse, type ListChatSchedulesResponse, type ListChatSessionsQuery, type ListChatSessionsResponse, type ListCredentialsQuery, type ListCreditsTransactionsQuery, type ListCreditsTransactionsResponse, type ListPaymentsResponse, type ListSandboxesQuery, type ListScanHistoryQuery, type ListScanHistoryResponse, type ListScheduledTasksQuery, type ListScheduledTasksResponse, type LoginRequest, type MFASetupResponse, type MFASimpleResponse, type MFAStatus, MFAType, type MFAVerifyLoginRequest, type MFAVerifyLoginResponse, type MFAVerifySetupRequest, type MagicLinkActivateRequest, type MagicLinkSendResponse, type ModeType, type MonthlyCreditStats, NotImplementedError, type NotifyChannelOption, type NotifyEventType, type NotifySubscription, type OpenChatStreamOptions, type OrgBudget, type OrgCreditBalance, type OrgNotifySubscriptions, OrgRoles, type OrgSubscription, type Organization, type OrganizationUser, PROVIDER_CATALOG, type Payment, type PeekScanLeaseResponse, type PostChatMessageRequest, type PostChatMessageResponse, type Project, type ProjectMember, type ProviderID, type ProviderSpec, ProviderType, type PublicConfig, type Query, type ReconcileScope, type ReconcileTuple, type RefreshRequest, type RegisterRequest, type RequestOptions, type ResetPasswordRequest, type ResourceTreeCategory, type ResourceTreeCredential, type ResourceTreeGrouping, type ResourceTreeResource, type ResourceTreeResponse, ResourcesClient, type Sandbox, type SandboxCredential, type ScanInProgressError, type ScheduledTask, type ScopedBudget, type SessionResponse, type SessionTokens, type SetOrgNotifySubscriptionsRequest, type SimpleAgentResponse, type SimpleKeysResponse, type SimpleOrgResponse, type SimpleResponse$2 as SimpleResponse, type StorageType, type SubgraphDirection, type SubgraphRequest, type SubgraphResponse, type SubmitChatFeedbackRequest, type Subscription, type SubscriptionCapability, type SubscriptionPeriod, type SystemEvent, type SystemEventQuery, type SystemEventQueryResponse, type SystemEventReadResponse, type Template, type TokenProvider, type UnauthorizedHandler, type UpdateChatBudgetRequest, type UpdateChatScheduleRequest, type UpdateCostLimitRequest, type UpdateCredentialRequest, type UpdateMemberRoleRequest, type UpdateOrgBudgetRequest, type UpdateOrgUserRequest, type UpdateOrganizationRequest, type UpdateProjectRequest, type UpdateSandboxRequest, type UpdateScopedBudgetRequest, type UpdateUserRequest, type UpdateUserResponse, type UsageBucket, type UsageByModelQuery, type UsageByModelResponse, type UsageByModelRow, type UsageCostSplit, type UsageReportQuery, type UsageReportResponse, type UsageSummary, type UsageSummaryQuery, type UsageSummaryResponse, type UsageTotals, type UsageWindow, type UserProfile, type UserSummary, computeDisplayHint, getProvider, getValueAt, isMetadataPath, isSecretPath, listProviders, metadataKey, setValueAt, usdMicros, validate };
+export { type AcceptInviteRequest, AccessType, type AcquireScanLeaseRequest, type AcquireScanLeaseResponse, type ActionCategory, type ActivateRequest, type AddMemberRequest, type AddUserToOrgRequest, type AddUserToOrgResult, type AdjustOrgCreditsRequest, type AdjustOrgCreditsResult, type AnswerChatQuestionRequest, type AnswerChatQuestionResponse, type AppendProgramConfigRequest, type AssociatedOrg, type AuthUser, BaseClient, type BaseClientOptions, type BillingProgramConfig, type BudgetScope, BudgetsClient, type BuyCreditPackRequest, type BuyCreditPackResponse, type BuyCustomCreditRequest, type BuyCustomCreditResponse, type BuySubscriptionRequest, type BuySubscriptionResponse, CAP_AI, CAP_COMPUTE, CAP_GENERAL, CAP_NOTIFY, CAP_STORAGE, CAP_VCS, type CancelChatTurnResponse, type CancelSubscriptionResponse, type ChatAssistantMessagePayload, type ChatBillingRefuseCode, type ChatBillingRefuseError, type ChatBudget, type ChatCheckpointedPayload, type ChatCompactionFiredPayload, type ChatDonePayload, type ChatEvent, type ChatEventType, type ChatFeedback, type ChatFeedbackEnvelope, type ChatMessage, type ChatMessageKind, type ChatMessageRole, type ChatNarrationPayload, type ChatPhase, type ChatPhasePayload, type ChatPlanDraftPayload, type ChatQuestionPayload, type ChatSchedule, type ChatScheduleEnvelope, type ChatScheduleNotifyOn, type ChatScheduleRunStatus, type ChatScope, type ChatSession, type ChatSessionSource, type ChatSessionTitlePayload, type ChatStepEventPayload, type ChatStepProgressPayload, type ChatStreamHandle, type ChatToolCallConfirmationRequiredPayload, type ChatToolCallFinishedPayload, type ChatToolCallStartedPayload, type ChatTurnStatus, type ClarificationOption, CloudAgentClient, type CloudAgentClientOptions, type CloudResource, type CloudResourceContainerRef, type CloudResourceEdge, type CloudScanHistory, type CloudScanLease, type ConfirmChatToolCallRequest, type ConfirmChatToolCallResponse, type CreateAgentTemplateRequest, type CreateChatScheduleRequest, type CreateChatSessionRequest, type CreateChatSessionResponse, type CreateCredentialRequest, type CreateGatewayTokenRequest, type CreateGatewayTokenResponse, type CreateOrganizationUserRequest, type CreateProjectRequest, type CreateSandboxRequest, type CreateScheduledTaskRequest, type Credential, type CreditBalance, type CreditPack, type CreditTransaction, type CreditTransactionKind, type CreditTransactionType, type CustomCreditPurchaseConfig, type DebugPayload, type DebugReceipt, type EffectiveChatBudget, type ExchangeCodeRequest, type FieldSpec, type FieldType, type FineTuneParams, type GatewayToken, type GeneratePayoutsRequest, type GetChatSessionResponse, type GetUsageSummaryQuery, type GetUsageSummaryResponse, HttpError, type ImpersonationProvider, type InviteOrgRequest, type InviteOrgResult, type ListAgentTemplatesQuery, type ListAgentTemplatesResponse, type ListChatFeedbackResponse, type ListChatScheduleRunsResponse, type ListChatSchedulesResponse, type ListChatSessionsQuery, type ListChatSessionsResponse, type ListCredentialsQuery, type ListCreditsTransactionsQuery, type ListCreditsTransactionsResponse, type ListPaymentsResponse, type ListSandboxesQuery, type ListScanHistoryQuery, type ListScanHistoryResponse, type ListScheduledTasksQuery, type ListScheduledTasksResponse, type LoginRequest, type MFASetupResponse, type MFASimpleResponse, type MFAStatus, MFAType, type MFAVerifyLoginRequest, type MFAVerifyLoginResponse, type MFAVerifySetupRequest, type MagicLinkActivateRequest, type MagicLinkSendResponse, type MintReferralCodeRequest, type ModeType, type MonthlyCreditStats, NotImplementedError, type NotifyChannelOption, type NotifyEventType, type NotifySubscription, type OpenChatStreamOptions, type OrgBudget, type OrgCreditBalance, type OrgNotifySubscriptions, OrgRoles, type OrgSubscription, type Organization, type OrganizationUser, PROVIDER_CATALOG, type Payment, type PeekScanLeaseResponse, type PostChatMessageRequest, type PostChatMessageResponse, type Project, type ProjectMember, type ProviderID, type ProviderSpec, ProviderType, type PublicConfig, type Query, type ReconcileScope, type ReconcileTuple, type RedeemReferralCodeRequest, type ReferralCode, type ReferralRedemption, type ReferralStats, ReferralsClient, type RefreshRequest, type RegisterRequest, type RequestOptions, ResellerClient, type ResellerCommission, type ResellerPayout, type ResellerPerformance, type ResetPasswordRequest, type ResourceTreeCategory, type ResourceTreeCredential, type ResourceTreeGrouping, type ResourceTreeResource, type ResourceTreeResponse, ResourcesClient, type Sandbox, type SandboxCredential, type ScanInProgressError, type ScheduledTask, type ScopedBudget, type SessionResponse, type SessionTokens, type SetOrgNotifySubscriptionsRequest, type SetResellerRequest, type SimpleAgentResponse, type SimpleKeysResponse, type SimpleOrgResponse, type SimpleResponse$2 as SimpleResponse, type StorageType, type SubgraphDirection, type SubgraphRequest, type SubgraphResponse, type SubmitChatFeedbackRequest, type Subscription, type SubscriptionCapability, type SubscriptionPeriod, type SystemEvent, type SystemEventQuery, type SystemEventQueryResponse, type SystemEventReadResponse, type Template, type TokenProvider, type UnauthorizedHandler, type UpdateChatBudgetRequest, type UpdateChatScheduleRequest, type UpdateCostLimitRequest, type UpdateCredentialRequest, type UpdateMemberRoleRequest, type UpdateOrgBudgetRequest, type UpdateOrgUserRequest, type UpdateOrganizationRequest, type UpdatePayoutRequest, type UpdateProjectRequest, type UpdateSandboxRequest, type UpdateScopedBudgetRequest, type UpdateUserRequest, type UpdateUserResponse, type UsageBucket, type UsageByModelQuery, type UsageByModelResponse, type UsageByModelRow, type UsageCostSplit, type UsageReportQuery, type UsageReportResponse, type UsageSummary, type UsageSummaryQuery, type UsageSummaryResponse, type UsageTotals, type UsageWindow, type UserProfile, type UserSummary, computeDisplayHint, getProvider, getValueAt, isMetadataPath, isSecretPath, listProviders, metadataKey, setValueAt, usdMicros, validate };

package/dist/index.js

@@ -1213,6 +1213,129 @@ var BudgetsClient = class {
   }
 };
 
+// src/modules/referrals/ReferralsClient.ts
+var ReferralsClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** Mint a new referral code for the caller's org. */
+  async mintCode(body = {}) {
+    const res = await this.http.post("/referrals/codes", { body });
+    return unwrapData(res);
+  }
+  /** List the caller org's codes with per-code redeemed/qualified counts. */
+  async listCodes() {
+    const res = await this.http.get("/referrals/codes");
+    return res.data ?? [];
+  }
+  /** Activate or deactivate one of the caller org's codes. */
+  async setCodeActive(codeId, isActive) {
+    const res = await this.http.patch(
+      `/referrals/codes/${codeId}`,
+      { body: { isActive } }
+    );
+    return unwrapData(res);
+  }
+  /** Caller org's referral summary as referrer (redemptions, qualified, credits earned). */
+  async stats() {
+    const res = await this.http.get("/referrals/stats");
+    return unwrapData(res);
+  }
+  /**
+   * Redeem a referral code for the caller's org. Fails (4xx with an
+   * `error_code`) when a guard rejects it: `code_inactive`, `self_referral`,
+   * `already_redeemed`, `already_associated`, or `has_purchases`.
+   */
+  async redeem(body) {
+    const res = await this.http.post(
+      "/referrals/redeem",
+      { body }
+    );
+    return unwrapData(res);
+  }
+};
+
+// src/modules/reseller/ResellerClient.ts
+var ResellerClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  // --- Reseller self-service (org.isReseller) ---
+  /** Orgs associated to the caller reseller, with gross + commission rollups. */
+  async listAssociatedOrgs() {
+    const res = await this.http.get("/reseller/associated-orgs");
+    return res.data ?? [];
+  }
+  /** The caller reseller's commission ledger. */
+  async listCommissions() {
+    const res = await this.http.get("/reseller/commissions");
+    return res.data ?? [];
+  }
+  /** The caller reseller's payout history. */
+  async listPayouts() {
+    const res = await this.http.get("/reseller/payouts");
+    return res.data ?? [];
+  }
+  // --- Platform-admin only ---
+  /** List all reseller orgs with aggregate performance. */
+  async listResellers() {
+    const res = await this.http.get("/admin/resellers");
+    return res.data ?? [];
+  }
+  /** Designate an org as a reseller (optionally with a per-reseller bps override). */
+  async setReseller(orgId, body = {}) {
+    const res = await this.http.post(
+      `/admin/orgs/${orgId}/reseller`,
+      { body }
+    );
+    return unwrapData(res);
+  }
+  /** Revoke an org's reseller status. */
+  async revokeReseller(orgId) {
+    const res = await this.http.delete(`/admin/orgs/${orgId}/reseller`);
+    return unwrapData(res);
+  }
+  /** End an org's reseller association (stamps resellerDetachedAt). */
+  async detachAssociation(orgId) {
+    const res = await this.http.post(
+      `/admin/orgs/${orgId}/detach-reseller`,
+      { body: {} }
+    );
+    return unwrapData(res);
+  }
+  /** The billing-program-config journal, newest first. */
+  async getProgramConfig() {
+    const res = await this.http.get(
+      "/admin/billing-program-config"
+    );
+    return res.data ?? [];
+  }
+  /** Append a new program-config period (closes the prior open row). */
+  async appendProgramConfig(body) {
+    const res = await this.http.post(
+      "/admin/billing-program-config",
+      { body }
+    );
+    return unwrapData(res);
+  }
+  /** Draft payouts from accrued commissions in the given period. */
+  async generatePayouts(body) {
+    const res = await this.http.post(
+      "/admin/reseller-payouts/generate",
+      { body }
+    );
+    return res.data ?? [];
+  }
+  /** Approve or mark-paid a payout (and optionally record an external ref). */
+  async updatePayout(payoutId, body) {
+    const res = await this.http.patch(
+      `/admin/reseller-payouts/${payoutId}`,
+      { body }
+    );
+    return unwrapData(res);
+  }
+};
+
 // src/client.ts
 var AgentEngineFacade = class {
   constructor(templates, scheduledTasks) {
@@ -1246,6 +1369,8 @@ var CloudAgentClient = class {
     this.billing = new BillingFacade(new SubscriptionsClient(this.http), new CreditsClient(this.http));
     this.usage = new UsageClient(this.http);
     this.budgets = new BudgetsClient(this.http);
+    this.referrals = new ReferralsClient(this.http);
+    this.reseller = new ResellerClient(this.http);
   }
 };
 
@@ -2080,6 +2205,6 @@ var usdMicros = {
   fromDollars: (dollars) => Math.round(dollars * 1e6)
 };
 
-export { AccessType, BaseClient, BudgetsClient, CAP_AI, CAP_COMPUTE, CAP_GENERAL, CAP_NOTIFY, CAP_STORAGE, CAP_VCS, CloudAgentClient, HttpError, MFAType, NotImplementedError, OrgRoles, PROVIDER_CATALOG, ProviderType, ResourcesClient, computeDisplayHint, getProvider, getValueAt, isMetadataPath, isSecretPath, listProviders, metadataKey, setValueAt, usdMicros, validate };
+export { AccessType, BaseClient, BudgetsClient, CAP_AI, CAP_COMPUTE, CAP_GENERAL, CAP_NOTIFY, CAP_STORAGE, CAP_VCS, CloudAgentClient, HttpError, MFAType, NotImplementedError, OrgRoles, PROVIDER_CATALOG, ProviderType, ReferralsClient, ResellerClient, ResourcesClient, computeDisplayHint, getProvider, getValueAt, isMetadataPath, isSecretPath, listProviders, metadataKey, setValueAt, usdMicros, validate };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map