@flashbacktech/tsclient 0.4.66 → 0.4.68

package/dist/index.d.cts

@@ -498,6 +498,52 @@ interface AdjustOrgCreditsResult {
         description?: string;
     };
 }
+/** Sortable columns on the platform-admin org summary. */
+type AdminOrgSummarySort = 'name' | 'users' | 'projects' | 'sandboxes' | 'billed' | 'purchases' | 'balance';
+/** Query for GET /admin/orgs/summary (platform-admin only). */
+interface AdminOrgSummaryQuery {
+    /** Case-insensitive name substring; empty/omitted returns all orgs. */
+    q?: string;
+    /** Page size (default 25, max 200). */
+    limit?: number;
+    /** Page offset (default 0). */
+    offset?: number;
+    sort?: AdminOrgSummarySort;
+    order?: 'asc' | 'desc';
+}
+/**
+ * One organization's row on the platform-admin summary screen. Counts and
+ * billing come from the backend DB; usage7d/30d are stitched in from the
+ * cloud-agent usage service (zero when that relay is unavailable). All money
+ * fields are USD micros.
+ */
+interface AdminOrgSummaryRow {
+    orgId: string;
+    orgName: string;
+    isBusiness: boolean;
+    isReseller: boolean;
+    userCount: number;
+    projectCount: number;
+    sandboxCount: number;
+    /** Total metered LLM/agent cost (byok+platform+agent), trailing windows. */
+    usage7dMicros: number;
+    usage30dMicros: number;
+    /** Billed-to-balance (credit debits), trailing windows. */
+    billed7dMicros: number;
+    billed30dMicros: number;
+    /** Lifetime COMPLETED payments (subscriptions + credit packs). */
+    purchasesMicros: number;
+    /** Current standing balance (permanent + subscription buckets). */
+    creditBalanceMicros: number;
+}
+/** Paged response for GET /admin/orgs/summary. */
+interface AdminOrgSummaryResponse {
+    rows: AdminOrgSummaryRow[];
+    /** Total orgs matching the search (for pagination), across all pages. */
+    total: number;
+    limit: number;
+    offset: number;
+}
 
 declare class OrganizationClient {
     private readonly http;
@@ -549,6 +595,14 @@ declare class OrganizationClient {
      * can show "N more — refine your search". Returns 403 unless platform admin.
      */
     searchOrgs(q?: string, limit?: number): Promise<OrgSearchResult>;
+    /**
+     * Platform-admin only: one page of the service-wide org summary — per-org
+     * user/project/sandbox counts, trailing 7d/30d metered usage, billed-to-
+     * balance, lifetime purchases and current credit balance — searchable by
+     * name and pageable. Backs the admin Summary screen. Returns 403 unless the
+     * caller's home org is the configured ADMIN_ORGANIZATION.
+     */
+    adminOrgSummary(query?: AdminOrgSummaryQuery): Promise<AdminOrgSummaryResponse>;
     /**
      * Platform-admin only: provision a new organization + founding owner and
      * email the owner an invite link. The invite-only counterpart to public
@@ -752,12 +806,41 @@ interface CreateGatewayTokenResponse {
     token: GatewayToken;
     secret: string;
 }
+interface AgentToken {
+    id: string;
+    sandboxId: string;
+    label: string;
+    tokenPrefix: string;
+    lastUsedAt?: string;
+    createdAt: string;
+}
+interface CreateAgentTokenRequest {
+    label: string;
+}
+interface CreateAgentTokenResponse {
+    token: AgentToken;
+    secret: string;
+}
 interface SimpleKeysResponse {
     success: boolean;
     message?: string;
     data?: unknown;
 }
 
+declare class AgentTokensClient {
+    private readonly http;
+    constructor(http: BaseClient);
+    list(sandboxId: string): Promise<AgentToken[]>;
+    /**
+     * create returns both the persisted token row and the plaintext bearer
+     * (`secret`). The bearer is shown only here; surface it to the user
+     * immediately. If they navigate away without copying, they must delete the
+     * token and create a new one.
+     */
+    create(sandboxId: string, body: CreateAgentTokenRequest): Promise<CreateAgentTokenResponse>;
+    delete(sandboxId: string, tokenId: string): Promise<SimpleKeysResponse>;
+}
+
 declare class GatewayTokensClient {
     private readonly http;
     constructor(http: BaseClient);
@@ -835,6 +918,8 @@ declare class CredentialsClient {
     private readonly http;
     readonly sandbox: SandboxCredentialScope;
     readonly gatewayTokens: GatewayTokensClient;
+    /** Sandbox agent access tokens — bearers external agents use against /mcp. */
+    readonly agentTokens: AgentTokensClient;
     constructor(http: BaseClient);
     list(query: ListCredentialsQuery): Promise<Credential[]>;
     create(body: CreateCredentialRequest): Promise<Credential>;
@@ -2783,4 +2868,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 AppendProgramConfigRequest, type AssociatedOrg, type AuthUser, type AvailableModels, 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 CreateOrganizationRequest, 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 ModelPricingRow, type ModelSelection, type MonthlyCreditStats, NotImplementedError, type NotifyChannelOption, type NotifyEventType, type NotifySubscription, type OpenChatStreamOptions, type OrgBudget, type OrgCreditBalance, type OrgInvite, type OrgNotifySubscriptions, type OrgRef, OrgRoles, type OrgSearchResult, type OrgSubscription, type Organization, type OrganizationUser, PROVIDER_CATALOG, type PatchModelSelectionRequest, type Payment, type PeekScanLeaseResponse, PlatformAdminClient, type PlatformSettings, type PostChatMessageRequest, type PostChatMessageResponse, type PreviewChangeRequest, type PreviewChangeResponse, type Project, type ProjectMember, type ProviderID, type ProviderSpec, ProviderType, type PublicConfig, type Query, type ReconcileScope, type ReconcileTuple, type RedeemReferralCodeRequest, type ReferralAdminOverview, type ReferralAdminStats, type ReferralCode, type ReferralRedemption, type ReferralRedemptionAdmin, 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 ScheduledChange, 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 UpdatePlatformSettingsRequest, 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 AdminOrgSummaryQuery, type AdminOrgSummaryResponse, type AdminOrgSummaryRow, type AdminOrgSummarySort, type AgentToken, type AnswerChatQuestionRequest, type AnswerChatQuestionResponse, type AppendProgramConfigRequest, type AssociatedOrg, type AuthUser, type AvailableModels, 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 CreateAgentTokenRequest, type CreateAgentTokenResponse, type CreateChatScheduleRequest, type CreateChatSessionRequest, type CreateChatSessionResponse, type CreateCredentialRequest, type CreateGatewayTokenRequest, type CreateGatewayTokenResponse, type CreateOrganizationRequest, 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 ModelPricingRow, type ModelSelection, type MonthlyCreditStats, NotImplementedError, type NotifyChannelOption, type NotifyEventType, type NotifySubscription, type OpenChatStreamOptions, type OrgBudget, type OrgCreditBalance, type OrgInvite, type OrgNotifySubscriptions, type OrgRef, OrgRoles, type OrgSearchResult, type OrgSubscription, type Organization, type OrganizationUser, PROVIDER_CATALOG, type PatchModelSelectionRequest, type Payment, type PeekScanLeaseResponse, PlatformAdminClient, type PlatformSettings, type PostChatMessageRequest, type PostChatMessageResponse, type PreviewChangeRequest, type PreviewChangeResponse, type Project, type ProjectMember, type ProviderID, type ProviderSpec, ProviderType, type PublicConfig, type Query, type ReconcileScope, type ReconcileTuple, type RedeemReferralCodeRequest, type ReferralAdminOverview, type ReferralAdminStats, type ReferralCode, type ReferralRedemption, type ReferralRedemptionAdmin, 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 ScheduledChange, 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 UpdatePlatformSettingsRequest, 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

@@ -498,6 +498,52 @@ interface AdjustOrgCreditsResult {
         description?: string;
     };
 }
+/** Sortable columns on the platform-admin org summary. */
+type AdminOrgSummarySort = 'name' | 'users' | 'projects' | 'sandboxes' | 'billed' | 'purchases' | 'balance';
+/** Query for GET /admin/orgs/summary (platform-admin only). */
+interface AdminOrgSummaryQuery {
+    /** Case-insensitive name substring; empty/omitted returns all orgs. */
+    q?: string;
+    /** Page size (default 25, max 200). */
+    limit?: number;
+    /** Page offset (default 0). */
+    offset?: number;
+    sort?: AdminOrgSummarySort;
+    order?: 'asc' | 'desc';
+}
+/**
+ * One organization's row on the platform-admin summary screen. Counts and
+ * billing come from the backend DB; usage7d/30d are stitched in from the
+ * cloud-agent usage service (zero when that relay is unavailable). All money
+ * fields are USD micros.
+ */
+interface AdminOrgSummaryRow {
+    orgId: string;
+    orgName: string;
+    isBusiness: boolean;
+    isReseller: boolean;
+    userCount: number;
+    projectCount: number;
+    sandboxCount: number;
+    /** Total metered LLM/agent cost (byok+platform+agent), trailing windows. */
+    usage7dMicros: number;
+    usage30dMicros: number;
+    /** Billed-to-balance (credit debits), trailing windows. */
+    billed7dMicros: number;
+    billed30dMicros: number;
+    /** Lifetime COMPLETED payments (subscriptions + credit packs). */
+    purchasesMicros: number;
+    /** Current standing balance (permanent + subscription buckets). */
+    creditBalanceMicros: number;
+}
+/** Paged response for GET /admin/orgs/summary. */
+interface AdminOrgSummaryResponse {
+    rows: AdminOrgSummaryRow[];
+    /** Total orgs matching the search (for pagination), across all pages. */
+    total: number;
+    limit: number;
+    offset: number;
+}
 
 declare class OrganizationClient {
     private readonly http;
@@ -549,6 +595,14 @@ declare class OrganizationClient {
      * can show "N more — refine your search". Returns 403 unless platform admin.
      */
     searchOrgs(q?: string, limit?: number): Promise<OrgSearchResult>;
+    /**
+     * Platform-admin only: one page of the service-wide org summary — per-org
+     * user/project/sandbox counts, trailing 7d/30d metered usage, billed-to-
+     * balance, lifetime purchases and current credit balance — searchable by
+     * name and pageable. Backs the admin Summary screen. Returns 403 unless the
+     * caller's home org is the configured ADMIN_ORGANIZATION.
+     */
+    adminOrgSummary(query?: AdminOrgSummaryQuery): Promise<AdminOrgSummaryResponse>;
     /**
      * Platform-admin only: provision a new organization + founding owner and
      * email the owner an invite link. The invite-only counterpart to public
@@ -752,12 +806,41 @@ interface CreateGatewayTokenResponse {
     token: GatewayToken;
     secret: string;
 }
+interface AgentToken {
+    id: string;
+    sandboxId: string;
+    label: string;
+    tokenPrefix: string;
+    lastUsedAt?: string;
+    createdAt: string;
+}
+interface CreateAgentTokenRequest {
+    label: string;
+}
+interface CreateAgentTokenResponse {
+    token: AgentToken;
+    secret: string;
+}
 interface SimpleKeysResponse {
     success: boolean;
     message?: string;
     data?: unknown;
 }
 
+declare class AgentTokensClient {
+    private readonly http;
+    constructor(http: BaseClient);
+    list(sandboxId: string): Promise<AgentToken[]>;
+    /**
+     * create returns both the persisted token row and the plaintext bearer
+     * (`secret`). The bearer is shown only here; surface it to the user
+     * immediately. If they navigate away without copying, they must delete the
+     * token and create a new one.
+     */
+    create(sandboxId: string, body: CreateAgentTokenRequest): Promise<CreateAgentTokenResponse>;
+    delete(sandboxId: string, tokenId: string): Promise<SimpleKeysResponse>;
+}
+
 declare class GatewayTokensClient {
     private readonly http;
     constructor(http: BaseClient);
@@ -835,6 +918,8 @@ declare class CredentialsClient {
     private readonly http;
     readonly sandbox: SandboxCredentialScope;
     readonly gatewayTokens: GatewayTokensClient;
+    /** Sandbox agent access tokens — bearers external agents use against /mcp. */
+    readonly agentTokens: AgentTokensClient;
     constructor(http: BaseClient);
     list(query: ListCredentialsQuery): Promise<Credential[]>;
     create(body: CreateCredentialRequest): Promise<Credential>;
@@ -2783,4 +2868,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 AppendProgramConfigRequest, type AssociatedOrg, type AuthUser, type AvailableModels, 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 CreateOrganizationRequest, 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 ModelPricingRow, type ModelSelection, type MonthlyCreditStats, NotImplementedError, type NotifyChannelOption, type NotifyEventType, type NotifySubscription, type OpenChatStreamOptions, type OrgBudget, type OrgCreditBalance, type OrgInvite, type OrgNotifySubscriptions, type OrgRef, OrgRoles, type OrgSearchResult, type OrgSubscription, type Organization, type OrganizationUser, PROVIDER_CATALOG, type PatchModelSelectionRequest, type Payment, type PeekScanLeaseResponse, PlatformAdminClient, type PlatformSettings, type PostChatMessageRequest, type PostChatMessageResponse, type PreviewChangeRequest, type PreviewChangeResponse, type Project, type ProjectMember, type ProviderID, type ProviderSpec, ProviderType, type PublicConfig, type Query, type ReconcileScope, type ReconcileTuple, type RedeemReferralCodeRequest, type ReferralAdminOverview, type ReferralAdminStats, type ReferralCode, type ReferralRedemption, type ReferralRedemptionAdmin, 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 ScheduledChange, 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 UpdatePlatformSettingsRequest, 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 AdminOrgSummaryQuery, type AdminOrgSummaryResponse, type AdminOrgSummaryRow, type AdminOrgSummarySort, type AgentToken, type AnswerChatQuestionRequest, type AnswerChatQuestionResponse, type AppendProgramConfigRequest, type AssociatedOrg, type AuthUser, type AvailableModels, 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 CreateAgentTokenRequest, type CreateAgentTokenResponse, type CreateChatScheduleRequest, type CreateChatSessionRequest, type CreateChatSessionResponse, type CreateCredentialRequest, type CreateGatewayTokenRequest, type CreateGatewayTokenResponse, type CreateOrganizationRequest, 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 ModelPricingRow, type ModelSelection, type MonthlyCreditStats, NotImplementedError, type NotifyChannelOption, type NotifyEventType, type NotifySubscription, type OpenChatStreamOptions, type OrgBudget, type OrgCreditBalance, type OrgInvite, type OrgNotifySubscriptions, type OrgRef, OrgRoles, type OrgSearchResult, type OrgSubscription, type Organization, type OrganizationUser, PROVIDER_CATALOG, type PatchModelSelectionRequest, type Payment, type PeekScanLeaseResponse, PlatformAdminClient, type PlatformSettings, type PostChatMessageRequest, type PostChatMessageResponse, type PreviewChangeRequest, type PreviewChangeResponse, type Project, type ProjectMember, type ProviderID, type ProviderSpec, ProviderType, type PublicConfig, type Query, type ReconcileScope, type ReconcileTuple, type RedeemReferralCodeRequest, type ReferralAdminOverview, type ReferralAdminStats, type ReferralCode, type ReferralRedemption, type ReferralRedemptionAdmin, 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 ScheduledChange, 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 UpdatePlatformSettingsRequest, 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

@@ -319,6 +319,20 @@ var OrganizationClient = class {
     });
     return unwrapData(res);
   }
+  /**
+   * Platform-admin only: one page of the service-wide org summary — per-org
+   * user/project/sandbox counts, trailing 7d/30d metered usage, billed-to-
+   * balance, lifetime purchases and current credit balance — searchable by
+   * name and pageable. Backs the admin Summary screen. Returns 403 unless the
+   * caller's home org is the configured ADMIN_ORGANIZATION.
+   */
+  async adminOrgSummary(query = {}) {
+    const res = await this.http.get(
+      "/admin/orgs/summary",
+      { query }
+    );
+    return unwrapData(res);
+  }
   /**
    * Platform-admin only: provision a new organization + founding owner and
    * email the owner an invite link. The invite-only counterpart to public
@@ -548,6 +562,49 @@ function normalizeGatewayToken(wire) {
     createdAt: wire.createdAt
   };
 }
+function normalizeAgentToken(wire) {
+  return {
+    id: wire.id,
+    sandboxId: wire.sandboxId ?? wire.repoId ?? "",
+    label: wire.label,
+    tokenPrefix: wire.tokenPrefix,
+    lastUsedAt: wire.lastUsedAt ?? void 0,
+    createdAt: wire.createdAt
+  };
+}
+
+// src/modules/credentials/AgentTokensClient.ts
+var AgentTokensClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  async list(sandboxId) {
+    const res = await this.http.get(
+      `/sandbox/${sandboxId}/agent-token`
+    );
+    const list = res.tokens ?? res.data ?? [];
+    return list.map(normalizeAgentToken);
+  }
+  /**
+   * create returns both the persisted token row and the plaintext bearer
+   * (`secret`). The bearer is shown only here; surface it to the user
+   * immediately. If they navigate away without copying, they must delete the
+   * token and create a new one.
+   */
+  async create(sandboxId, body) {
+    const res = await this.http.post(`/sandbox/${sandboxId}/agent-token`, { body });
+    if (!res.token || !res.secret) {
+      throw new Error("createAgentToken response missing token or secret.");
+    }
+    return {
+      token: normalizeAgentToken(res.token),
+      secret: res.secret
+    };
+  }
+  delete(sandboxId, tokenId) {
+    return this.http.delete(`/sandbox/${sandboxId}/agent-token/${tokenId}`);
+  }
+};
 
 // src/modules/credentials/GatewayTokensClient.ts
 var GatewayTokensClient = class {
@@ -608,6 +665,7 @@ var CredentialsClient = class {
     this.http = http;
     this.sandbox = new SandboxCredentialScope(http);
     this.gatewayTokens = new GatewayTokensClient(http);
+    this.agentTokens = new AgentTokensClient(http);
   }
   async list(query) {
     const res = await this.http.get(