@flashbacktech/tsclient 0.4.33 → 0.4.36

package/dist/index.d.cts

@@ -822,7 +822,7 @@ interface ClarificationOption {
     label: string;
     description?: string;
 }
-type ChatEventType = 'phase' | 'question' | 'plan_draft' | 'step_started' | 'step_completed' | 'step_failed' | 'step_progress' | 'narration' | 'assistant_message' | 'done' | 'session_title' | 'tool_call_started' | 'tool_call_finished' | 'llm_call_finished' | 'tool_call_confirmation_required';
+type ChatEventType = 'phase' | 'question' | 'plan_draft' | 'step_started' | 'step_completed' | 'step_failed' | 'step_progress' | 'narration' | 'assistant_message' | 'done' | 'session_title' | 'tool_call_started' | 'tool_call_finished' | 'llm_call_finished' | 'tool_call_confirmation_required' | 'chat_compaction_fired' | 'chat_checkpointed';
 type ChatPhase = 'classifying' | 'clarifying' | 'executing' | 'answering' | 'done';
 interface ChatPhasePayload {
     phase: ChatPhase;
@@ -957,13 +957,38 @@ interface ChatDonePayload {
 interface ChatSessionTitlePayload {
     title: string;
 }
+/**
+ * Sent with `chat_compaction_fired` once per Run when the chat-loop
+ * mid-session replaces older history with a structured progress note
+ * (chat-compact-optimization Front #1). The session-debug view uses
+ * this to mark the boundary in the rendered transcript so operators
+ * can see how aggressively the loop is trimming context.
+ */
+interface ChatCompactionFiredPayload {
+    turn_index: number;
+    prompt_tokens_before: number;
+    compactor_model: string;
+}
+/**
+ * Sent with `chat_checkpointed` when the chat-loop, on its final
+ * allowed iteration, emits a structured terminal summary instead of
+ * running another open-ended LLM call (chat-compact-optimization Front
+ * #2). The accompanying assistant message is the checkpoint body; the
+ * dashboard should render the session's StopReason
+ * ("max_turns_checkpointed") with a distinct chip and offer a "Continue
+ * this work" affordance that POSTs a canned follow-up.
+ */
+interface ChatCheckpointedPayload {
+    turn_index: number;
+    checkpoint_model: string;
+}
 interface ChatEvent {
     conversation_id: string;
     turn_id: string;
     type: ChatEventType;
     plan_id?: string;
     step_id?: string;
-    payload?: ChatPhasePayload | ChatQuestionPayload | ChatPlanDraftPayload | ChatStepEventPayload | ChatStepProgressPayload | ChatNarrationPayload | ChatAssistantMessagePayload | ChatDonePayload | ChatSessionTitlePayload | ChatToolCallStartedPayload | ChatToolCallFinishedPayload | ChatLLMCallFinishedPayload | ChatToolCallConfirmationRequiredPayload | unknown;
+    payload?: ChatPhasePayload | ChatQuestionPayload | ChatPlanDraftPayload | ChatStepEventPayload | ChatStepProgressPayload | ChatNarrationPayload | ChatAssistantMessagePayload | ChatDonePayload | ChatSessionTitlePayload | ChatToolCallStartedPayload | ChatToolCallFinishedPayload | ChatLLMCallFinishedPayload | ChatToolCallConfirmationRequiredPayload | ChatCompactionFiredPayload | ChatCheckpointedPayload | unknown;
     timestamp: string;
     event_id?: number;
 }
@@ -1510,8 +1535,8 @@ interface SubscriptionPeriod {
     currency: string;
     interval: string;
     intervalCount?: number;
-    /** Per-period grant in USD-cents. 0 means no grant attached. */
-    creditsGrantedCents: number;
+    /** Per-period grant in USD micros. 0 means no grant attached. */
+    creditsGrantedMicros: number;
 }
 interface SubscriptionCapability {
     key: string;
@@ -1524,8 +1549,8 @@ interface Subscription {
     description?: string;
     periods: SubscriptionPeriod[];
     capabilities: SubscriptionCapability[];
-    /** Plan-level 24h rolling debit cap in USD-cents. null = no cap. */
-    dailyCreditCapCents?: number | null;
+    /** Plan-level 24h rolling debit cap in USD micros. null = no cap. */
+    dailyCreditCapMicros?: number | null;
 }
 interface OrgSubscription {
     id: string;
@@ -1571,28 +1596,24 @@ interface ListPaymentsResponse {
 /**
  * Org credit balance — two-bucket forfeit model (billing-v1).
  *
- *  - permanentCreditCents:        PAYG (credit-pack) bucket. Never expires.
- *  - subscriptionCreditCents:     Current subscription cycle. Forfeit on
- *                                  renewal; expires at subscriptionCreditExpiresAt.
- *  - subscriptionCreditExpiresAt: ISO-8601; null when no subscription is active.
- *  - totalActiveCents:            Pre-computed sum = permanent +
- *                                  (subscription if not expired). Use this
- *                                  to drive the daily-cap progress bar
- *                                  and "out of credits" check.
- *
- * Format `(value / 100).toFixed(2)` for display. Drain order is
- * subscription bucket first, then permanent — visualise as a single
- * pool with a small "expires soon" tag for the subscription slice.
+ *  - permanentCreditMicros:        PAYG (credit-pack) bucket. Never expires.
+ *  - subscriptionCreditMicros:     Current subscription cycle. Forfeit on
+ *                                   renewal; expires at subscriptionCreditExpiresAt.
+ *  - subscriptionCreditExpiresAt:  ISO-8601; null when no subscription is active.
+ *  - totalActiveMicros:            Pre-computed sum = permanent +
+ *                                   (subscription if not expired). Use this
+ *                                   to drive the daily-cap progress bar
+ *                                   and "out of credits" check.
  *
- * Legacy `realtimeBalance` / `pendingConsumption` / `breakdown` /
- * `dateBalance` fields were dropped: the chat-loop debits in real-time
- * so there is no notion of "pending".
+ * Format `(value / 1_000_000).toFixed(2)` for dollar layouts. Drain
+ * order is subscription bucket first, then permanent — visualise as a
+ * single pool with a small "expires soon" tag for the subscription slice.
  */
 interface CreditBalance {
-    permanentCreditCents: number;
-    subscriptionCreditCents: number;
+    permanentCreditMicros: number;
+    subscriptionCreditMicros: number;
     subscriptionCreditExpiresAt: string | null;
-    totalActiveCents: number;
+    totalActiveMicros: number;
 }
 /** Source of a credit ledger row. Matches the kind enum from migration 0017. */
 type CreditTransactionKind = 'grant_initial' | 'grant_renewal' | 'grant_pack' | 'debit_llm' | 'debit_sandbox' | 'admin_adjust';
@@ -1600,8 +1621,8 @@ type CreditTransactionKind = 'grant_initial' | 'grant_renewal' | 'grant_pack' |
 type CreditTransactionType = 'consumption' | 'purchase' | 'grant';
 interface CreditTransaction {
     id: string;
-    /** Signed amount in USD-cents. Negative = debit. */
-    creditAmountCents: number;
+    /** Signed amount in USD micros. Negative = debit. */
+    creditAmountMicros: number;
     kind: CreditTransactionKind;
     type: CreditTransactionType;
     description?: string;
@@ -1628,13 +1649,47 @@ interface ListCreditsTransactionsResponse {
         limit: number;
     };
 }
-/** One month's bucket of credit activity. All money values in USD-cents. */
+/** One month's bucket of credit activity. All money values in USD micros. */
 interface MonthlyCreditStats {
     month: string;
-    consumptionCents: number;
-    purchasesCents: number;
-    grantsCents: number;
-    balanceCents: number;
+    consumptionMicros: number;
+    purchasesMicros: number;
+    grantsMicros: number;
+    balanceMicros: number;
+}
+/**
+ * "Other amount" PAYG purchase config, served by
+ * GET /credits/packs/custom-config. Disabled =>
+ * `{ enabled: false, minMicros: 0, maxMicros: 0, presetMicros: [] }` so
+ * the frontend can hide the tile cleanly without nil checks.
+ */
+interface CustomCreditPurchaseConfig {
+    enabled: boolean;
+    minMicros: number;
+    maxMicros: number;
+    /** Suggested one-click amounts (in USD micros) for the "Other" tile. */
+    presetMicros: number[];
+}
+/**
+ * Body for POST /credits/packs/buy-custom. `amountMicros` is the
+ * arbitrary dollar amount the user typed, converted to USD micros
+ * before the API call. Server enforces `min <= amount <= max`.
+ * Credit ratio is 1:1 (pay $X, get $X of credits in the permanent
+ * bucket). Stripe charges in cents — the backend divides by 10000 at
+ * the API boundary, so amounts that aren't multiples of 10000 micros
+ * incur tiny rounding loss at the Stripe step (presetMicros + minMicros
+ * should be 10000-aligned).
+ */
+interface BuyCustomCreditRequest {
+    amountMicros: number;
+}
+/** Response from POST /credits/packs/buy-custom. Mirrors the fixed-pack response. */
+interface BuyCustomCreditResponse {
+    success: boolean;
+    checkoutUrl?: string;
+    sessionId?: string;
+    error_code?: string;
+    message?: string;
 }
 /**
  * Refusal reasons from POST /v1/agent/chat/sessions/:id/messages when
@@ -1645,12 +1700,12 @@ type ChatBillingRefuseCode = 'out_of_credits' | 'daily_cap_reached' | 'no_subscr
 interface ChatBillingRefuseError {
     message: string;
     code: ChatBillingRefuseCode;
-    permanentCreditCents: number;
-    subscriptionCreditCents: number;
+    permanentCreditMicros: number;
+    subscriptionCreditMicros: number;
     subscriptionCreditExpiresAt: string | null;
-    totalActiveCents: number;
-    dailyCapCents: number;
-    debitedLast24hCents: number;
+    totalActiveMicros: number;
+    dailyCapMicros: number;
+    debitedLast24hMicros: number;
 }
 
 declare class SubscriptionsClient {
@@ -1674,6 +1729,20 @@ declare class CreditsClient {
     listTransactions(query?: ListCreditsTransactionsQuery): Promise<ListCreditsTransactionsResponse>;
     /** Backend currently returns 501. Surfaced for forward-compat. */
     getMonthlyStats(): Promise<MonthlyCreditStats[]>;
+    /**
+     * "Other amount" PAYG config — bounds + presets for the
+     * arbitrary-dollar tile. Public endpoint; returns a disabled
+     * shape (`enabled: false`) when the feature is off so the
+     * frontend can hide the tile without throwing.
+     */
+    getCustomConfig(): Promise<CustomCreditPurchaseConfig>;
+    /**
+     * Buy an arbitrary-dollar PAYG amount. The Stripe Checkout
+     * session is built with `price_data` inline (no pre-created
+     * Price), so the catalog has nothing to provision for this — it
+     * is purely a per-purchase flow.
+     */
+    buyCustom(body: BuyCustomCreditRequest): Promise<BuyCustomCreditResponse>;
 }
 
 interface UsageWindow {
@@ -1950,4 +2019,4 @@ declare class NotImplementedError extends Error {
     constructor(method: string);
 }
 
-export { type AcceptInviteRequest, AccessType, type AcquireScanLeaseRequest, type AcquireScanLeaseResponse, type ActionCategory, type ActivateRequest, type AddMemberRequest, type AnswerChatQuestionRequest, type AnswerChatQuestionResponse, type AuthUser, BaseClient, type BaseClientOptions, type BudgetScope, BudgetsClient, type BuySubscriptionRequest, type BuySubscriptionResponse, CAP_AI, CAP_COMPUTE, CAP_GENERAL, CAP_STORAGE, CAP_VCS, type CancelChatTurnResponse, type CancelSubscriptionResponse, type ChatAssistantMessagePayload, type ChatBillingRefuseCode, type ChatBillingRefuseError, type ChatBudget, type ChatDonePayload, type ChatEvent, type ChatEventType, type ChatMessage, type ChatMessageKind, type ChatMessageRole, type ChatNarrationPayload, type ChatPhase, type ChatPhasePayload, type ChatPlanDraftPayload, type ChatQuestionPayload, type ChatSchedule, type ChatScheduleEnvelope, type ChatScheduleRunStatus, type ChatScope, type ChatSession, type ChatSessionSource, type ChatSessionTitlePayload, type ChatStepEventPayload, type ChatStepProgressPayload, type ChatStreamHandle, type ChatToolCallConfirmationRequiredPayload, type ChatToolCallFinishedPayload, type ChatToolCallStartedPayload, 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 CreditTransaction, type CreditTransactionKind, type CreditTransactionType, 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 ListAgentTemplatesQuery, type ListAgentTemplatesResponse, 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 OpenChatStreamOptions, type OrgBudget, 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 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 SimpleAgentResponse, type SimpleKeysResponse, type SimpleOrgResponse, type SimpleResponse$2 as SimpleResponse, type StorageType, type SubgraphDirection, type SubgraphRequest, type SubgraphResponse, 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 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 AnswerChatQuestionRequest, type AnswerChatQuestionResponse, type AuthUser, BaseClient, type BaseClientOptions, type BudgetScope, BudgetsClient, type BuyCustomCreditRequest, type BuyCustomCreditResponse, type BuySubscriptionRequest, type BuySubscriptionResponse, CAP_AI, CAP_COMPUTE, CAP_GENERAL, 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 ChatMessage, type ChatMessageKind, type ChatMessageRole, type ChatNarrationPayload, type ChatPhase, type ChatPhasePayload, type ChatPlanDraftPayload, type ChatQuestionPayload, type ChatSchedule, type ChatScheduleEnvelope, type ChatScheduleRunStatus, type ChatScope, type ChatSession, type ChatSessionSource, type ChatSessionTitlePayload, type ChatStepEventPayload, type ChatStepProgressPayload, type ChatStreamHandle, type ChatToolCallConfirmationRequiredPayload, type ChatToolCallFinishedPayload, type ChatToolCallStartedPayload, 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 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 ListAgentTemplatesQuery, type ListAgentTemplatesResponse, 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 OpenChatStreamOptions, type OrgBudget, 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 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 SimpleAgentResponse, type SimpleKeysResponse, type SimpleOrgResponse, type SimpleResponse$2 as SimpleResponse, type StorageType, type SubgraphDirection, type SubgraphRequest, type SubgraphResponse, 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 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

@@ -822,7 +822,7 @@ interface ClarificationOption {
     label: string;
     description?: string;
 }
-type ChatEventType = 'phase' | 'question' | 'plan_draft' | 'step_started' | 'step_completed' | 'step_failed' | 'step_progress' | 'narration' | 'assistant_message' | 'done' | 'session_title' | 'tool_call_started' | 'tool_call_finished' | 'llm_call_finished' | 'tool_call_confirmation_required';
+type ChatEventType = 'phase' | 'question' | 'plan_draft' | 'step_started' | 'step_completed' | 'step_failed' | 'step_progress' | 'narration' | 'assistant_message' | 'done' | 'session_title' | 'tool_call_started' | 'tool_call_finished' | 'llm_call_finished' | 'tool_call_confirmation_required' | 'chat_compaction_fired' | 'chat_checkpointed';
 type ChatPhase = 'classifying' | 'clarifying' | 'executing' | 'answering' | 'done';
 interface ChatPhasePayload {
     phase: ChatPhase;
@@ -957,13 +957,38 @@ interface ChatDonePayload {
 interface ChatSessionTitlePayload {
     title: string;
 }
+/**
+ * Sent with `chat_compaction_fired` once per Run when the chat-loop
+ * mid-session replaces older history with a structured progress note
+ * (chat-compact-optimization Front #1). The session-debug view uses
+ * this to mark the boundary in the rendered transcript so operators
+ * can see how aggressively the loop is trimming context.
+ */
+interface ChatCompactionFiredPayload {
+    turn_index: number;
+    prompt_tokens_before: number;
+    compactor_model: string;
+}
+/**
+ * Sent with `chat_checkpointed` when the chat-loop, on its final
+ * allowed iteration, emits a structured terminal summary instead of
+ * running another open-ended LLM call (chat-compact-optimization Front
+ * #2). The accompanying assistant message is the checkpoint body; the
+ * dashboard should render the session's StopReason
+ * ("max_turns_checkpointed") with a distinct chip and offer a "Continue
+ * this work" affordance that POSTs a canned follow-up.
+ */
+interface ChatCheckpointedPayload {
+    turn_index: number;
+    checkpoint_model: string;
+}
 interface ChatEvent {
     conversation_id: string;
     turn_id: string;
     type: ChatEventType;
     plan_id?: string;
     step_id?: string;
-    payload?: ChatPhasePayload | ChatQuestionPayload | ChatPlanDraftPayload | ChatStepEventPayload | ChatStepProgressPayload | ChatNarrationPayload | ChatAssistantMessagePayload | ChatDonePayload | ChatSessionTitlePayload | ChatToolCallStartedPayload | ChatToolCallFinishedPayload | ChatLLMCallFinishedPayload | ChatToolCallConfirmationRequiredPayload | unknown;
+    payload?: ChatPhasePayload | ChatQuestionPayload | ChatPlanDraftPayload | ChatStepEventPayload | ChatStepProgressPayload | ChatNarrationPayload | ChatAssistantMessagePayload | ChatDonePayload | ChatSessionTitlePayload | ChatToolCallStartedPayload | ChatToolCallFinishedPayload | ChatLLMCallFinishedPayload | ChatToolCallConfirmationRequiredPayload | ChatCompactionFiredPayload | ChatCheckpointedPayload | unknown;
     timestamp: string;
     event_id?: number;
 }
@@ -1510,8 +1535,8 @@ interface SubscriptionPeriod {
     currency: string;
     interval: string;
     intervalCount?: number;
-    /** Per-period grant in USD-cents. 0 means no grant attached. */
-    creditsGrantedCents: number;
+    /** Per-period grant in USD micros. 0 means no grant attached. */
+    creditsGrantedMicros: number;
 }
 interface SubscriptionCapability {
     key: string;
@@ -1524,8 +1549,8 @@ interface Subscription {
     description?: string;
     periods: SubscriptionPeriod[];
     capabilities: SubscriptionCapability[];
-    /** Plan-level 24h rolling debit cap in USD-cents. null = no cap. */
-    dailyCreditCapCents?: number | null;
+    /** Plan-level 24h rolling debit cap in USD micros. null = no cap. */
+    dailyCreditCapMicros?: number | null;
 }
 interface OrgSubscription {
     id: string;
@@ -1571,28 +1596,24 @@ interface ListPaymentsResponse {
 /**
  * Org credit balance — two-bucket forfeit model (billing-v1).
  *
- *  - permanentCreditCents:        PAYG (credit-pack) bucket. Never expires.
- *  - subscriptionCreditCents:     Current subscription cycle. Forfeit on
- *                                  renewal; expires at subscriptionCreditExpiresAt.
- *  - subscriptionCreditExpiresAt: ISO-8601; null when no subscription is active.
- *  - totalActiveCents:            Pre-computed sum = permanent +
- *                                  (subscription if not expired). Use this
- *                                  to drive the daily-cap progress bar
- *                                  and "out of credits" check.
- *
- * Format `(value / 100).toFixed(2)` for display. Drain order is
- * subscription bucket first, then permanent — visualise as a single
- * pool with a small "expires soon" tag for the subscription slice.
+ *  - permanentCreditMicros:        PAYG (credit-pack) bucket. Never expires.
+ *  - subscriptionCreditMicros:     Current subscription cycle. Forfeit on
+ *                                   renewal; expires at subscriptionCreditExpiresAt.
+ *  - subscriptionCreditExpiresAt:  ISO-8601; null when no subscription is active.
+ *  - totalActiveMicros:            Pre-computed sum = permanent +
+ *                                   (subscription if not expired). Use this
+ *                                   to drive the daily-cap progress bar
+ *                                   and "out of credits" check.
  *
- * Legacy `realtimeBalance` / `pendingConsumption` / `breakdown` /
- * `dateBalance` fields were dropped: the chat-loop debits in real-time
- * so there is no notion of "pending".
+ * Format `(value / 1_000_000).toFixed(2)` for dollar layouts. Drain
+ * order is subscription bucket first, then permanent — visualise as a
+ * single pool with a small "expires soon" tag for the subscription slice.
  */
 interface CreditBalance {
-    permanentCreditCents: number;
-    subscriptionCreditCents: number;
+    permanentCreditMicros: number;
+    subscriptionCreditMicros: number;
     subscriptionCreditExpiresAt: string | null;
-    totalActiveCents: number;
+    totalActiveMicros: number;
 }
 /** Source of a credit ledger row. Matches the kind enum from migration 0017. */
 type CreditTransactionKind = 'grant_initial' | 'grant_renewal' | 'grant_pack' | 'debit_llm' | 'debit_sandbox' | 'admin_adjust';
@@ -1600,8 +1621,8 @@ type CreditTransactionKind = 'grant_initial' | 'grant_renewal' | 'grant_pack' |
 type CreditTransactionType = 'consumption' | 'purchase' | 'grant';
 interface CreditTransaction {
     id: string;
-    /** Signed amount in USD-cents. Negative = debit. */
-    creditAmountCents: number;
+    /** Signed amount in USD micros. Negative = debit. */
+    creditAmountMicros: number;
     kind: CreditTransactionKind;
     type: CreditTransactionType;
     description?: string;
@@ -1628,13 +1649,47 @@ interface ListCreditsTransactionsResponse {
         limit: number;
     };
 }
-/** One month's bucket of credit activity. All money values in USD-cents. */
+/** One month's bucket of credit activity. All money values in USD micros. */
 interface MonthlyCreditStats {
     month: string;
-    consumptionCents: number;
-    purchasesCents: number;
-    grantsCents: number;
-    balanceCents: number;
+    consumptionMicros: number;
+    purchasesMicros: number;
+    grantsMicros: number;
+    balanceMicros: number;
+}
+/**
+ * "Other amount" PAYG purchase config, served by
+ * GET /credits/packs/custom-config. Disabled =>
+ * `{ enabled: false, minMicros: 0, maxMicros: 0, presetMicros: [] }` so
+ * the frontend can hide the tile cleanly without nil checks.
+ */
+interface CustomCreditPurchaseConfig {
+    enabled: boolean;
+    minMicros: number;
+    maxMicros: number;
+    /** Suggested one-click amounts (in USD micros) for the "Other" tile. */
+    presetMicros: number[];
+}
+/**
+ * Body for POST /credits/packs/buy-custom. `amountMicros` is the
+ * arbitrary dollar amount the user typed, converted to USD micros
+ * before the API call. Server enforces `min <= amount <= max`.
+ * Credit ratio is 1:1 (pay $X, get $X of credits in the permanent
+ * bucket). Stripe charges in cents — the backend divides by 10000 at
+ * the API boundary, so amounts that aren't multiples of 10000 micros
+ * incur tiny rounding loss at the Stripe step (presetMicros + minMicros
+ * should be 10000-aligned).
+ */
+interface BuyCustomCreditRequest {
+    amountMicros: number;
+}
+/** Response from POST /credits/packs/buy-custom. Mirrors the fixed-pack response. */
+interface BuyCustomCreditResponse {
+    success: boolean;
+    checkoutUrl?: string;
+    sessionId?: string;
+    error_code?: string;
+    message?: string;
 }
 /**
  * Refusal reasons from POST /v1/agent/chat/sessions/:id/messages when
@@ -1645,12 +1700,12 @@ type ChatBillingRefuseCode = 'out_of_credits' | 'daily_cap_reached' | 'no_subscr
 interface ChatBillingRefuseError {
     message: string;
     code: ChatBillingRefuseCode;
-    permanentCreditCents: number;
-    subscriptionCreditCents: number;
+    permanentCreditMicros: number;
+    subscriptionCreditMicros: number;
     subscriptionCreditExpiresAt: string | null;
-    totalActiveCents: number;
-    dailyCapCents: number;
-    debitedLast24hCents: number;
+    totalActiveMicros: number;
+    dailyCapMicros: number;
+    debitedLast24hMicros: number;
 }
 
 declare class SubscriptionsClient {
@@ -1674,6 +1729,20 @@ declare class CreditsClient {
     listTransactions(query?: ListCreditsTransactionsQuery): Promise<ListCreditsTransactionsResponse>;
     /** Backend currently returns 501. Surfaced for forward-compat. */
     getMonthlyStats(): Promise<MonthlyCreditStats[]>;
+    /**
+     * "Other amount" PAYG config — bounds + presets for the
+     * arbitrary-dollar tile. Public endpoint; returns a disabled
+     * shape (`enabled: false`) when the feature is off so the
+     * frontend can hide the tile without throwing.
+     */
+    getCustomConfig(): Promise<CustomCreditPurchaseConfig>;
+    /**
+     * Buy an arbitrary-dollar PAYG amount. The Stripe Checkout
+     * session is built with `price_data` inline (no pre-created
+     * Price), so the catalog has nothing to provision for this — it
+     * is purely a per-purchase flow.
+     */
+    buyCustom(body: BuyCustomCreditRequest): Promise<BuyCustomCreditResponse>;
 }
 
 interface UsageWindow {
@@ -1950,4 +2019,4 @@ declare class NotImplementedError extends Error {
     constructor(method: string);
 }
 
-export { type AcceptInviteRequest, AccessType, type AcquireScanLeaseRequest, type AcquireScanLeaseResponse, type ActionCategory, type ActivateRequest, type AddMemberRequest, type AnswerChatQuestionRequest, type AnswerChatQuestionResponse, type AuthUser, BaseClient, type BaseClientOptions, type BudgetScope, BudgetsClient, type BuySubscriptionRequest, type BuySubscriptionResponse, CAP_AI, CAP_COMPUTE, CAP_GENERAL, CAP_STORAGE, CAP_VCS, type CancelChatTurnResponse, type CancelSubscriptionResponse, type ChatAssistantMessagePayload, type ChatBillingRefuseCode, type ChatBillingRefuseError, type ChatBudget, type ChatDonePayload, type ChatEvent, type ChatEventType, type ChatMessage, type ChatMessageKind, type ChatMessageRole, type ChatNarrationPayload, type ChatPhase, type ChatPhasePayload, type ChatPlanDraftPayload, type ChatQuestionPayload, type ChatSchedule, type ChatScheduleEnvelope, type ChatScheduleRunStatus, type ChatScope, type ChatSession, type ChatSessionSource, type ChatSessionTitlePayload, type ChatStepEventPayload, type ChatStepProgressPayload, type ChatStreamHandle, type ChatToolCallConfirmationRequiredPayload, type ChatToolCallFinishedPayload, type ChatToolCallStartedPayload, 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 CreditTransaction, type CreditTransactionKind, type CreditTransactionType, 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 ListAgentTemplatesQuery, type ListAgentTemplatesResponse, 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 OpenChatStreamOptions, type OrgBudget, 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 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 SimpleAgentResponse, type SimpleKeysResponse, type SimpleOrgResponse, type SimpleResponse$2 as SimpleResponse, type StorageType, type SubgraphDirection, type SubgraphRequest, type SubgraphResponse, 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 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 AnswerChatQuestionRequest, type AnswerChatQuestionResponse, type AuthUser, BaseClient, type BaseClientOptions, type BudgetScope, BudgetsClient, type BuyCustomCreditRequest, type BuyCustomCreditResponse, type BuySubscriptionRequest, type BuySubscriptionResponse, CAP_AI, CAP_COMPUTE, CAP_GENERAL, 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 ChatMessage, type ChatMessageKind, type ChatMessageRole, type ChatNarrationPayload, type ChatPhase, type ChatPhasePayload, type ChatPlanDraftPayload, type ChatQuestionPayload, type ChatSchedule, type ChatScheduleEnvelope, type ChatScheduleRunStatus, type ChatScope, type ChatSession, type ChatSessionSource, type ChatSessionTitlePayload, type ChatStepEventPayload, type ChatStepProgressPayload, type ChatStreamHandle, type ChatToolCallConfirmationRequiredPayload, type ChatToolCallFinishedPayload, type ChatToolCallStartedPayload, 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 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 ListAgentTemplatesQuery, type ListAgentTemplatesResponse, 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 OpenChatStreamOptions, type OrgBudget, 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 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 SimpleAgentResponse, type SimpleKeysResponse, type SimpleOrgResponse, type SimpleResponse$2 as SimpleResponse, type StorageType, type SubgraphDirection, type SubgraphRequest, type SubgraphResponse, 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 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

@@ -964,6 +964,25 @@ var CreditsClient = class {
     const res = await this.http.get("/credits/stats/monthly");
     return res.data ?? [];
   }
+  /**
+   * "Other amount" PAYG config — bounds + presets for the
+   * arbitrary-dollar tile. Public endpoint; returns a disabled
+   * shape (`enabled: false`) when the feature is off so the
+   * frontend can hide the tile without throwing.
+   */
+  async getCustomConfig() {
+    const res = await this.http.get("/credits/packs/custom-config");
+    return unwrapData(res);
+  }
+  /**
+   * Buy an arbitrary-dollar PAYG amount. The Stripe Checkout
+   * session is built with `price_data` inline (no pre-created
+   * Price), so the catalog has nothing to provision for this — it
+   * is purely a per-purchase flow.
+   */
+  buyCustom(body) {
+    return this.http.post("/credits/packs/buy-custom", { body });
+  }
 };
 
 // src/modules/usage/UsageClient.ts