@stigmer/protos 0.3.3 → 0.4.0

package/ai/stigmer/billing/v1/io_pb.d.ts

@@ -0,0 +1,801 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { ProxyTiming, TokenUsage, UsageCompletionStatus } from "../../agentic/agentexecution/v1/usage_pb.js";
+import type { CreditLedgerEntry } from "./credit_pb.js";
+import type { LedgerEntryType } from "./enum_pb.js";
+import type { PageInfo } from "../../commons/rpc/pagination_pb.js";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/billing/v1/io.proto.
+ */
+export declare const file_ai_stigmer_billing_v1_io: GenFile;
+/**
+ * GetOrCreateBillingAccountInput initiates billing for an organization.
+ * Idempotent: returns the existing account if one already exists.
+ *
+ * @generated from message ai.stigmer.billing.v1.GetOrCreateBillingAccountInput
+ */
+export type GetOrCreateBillingAccountInput = Message<"ai.stigmer.billing.v1.GetOrCreateBillingAccountInput"> & {
+    /**
+     * @generated from field: string org_id = 1;
+     */
+    orgId: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.GetOrCreateBillingAccountInput.
+ * Use `create(GetOrCreateBillingAccountInputSchema)` to create a new message.
+ */
+export declare const GetOrCreateBillingAccountInputSchema: GenMessage<GetOrCreateBillingAccountInput>;
+/**
+ * AdjustCreditsInput allows platform admins to manually add or remove credits.
+ *
+ * @generated from message ai.stigmer.billing.v1.AdjustCreditsInput
+ */
+export type AdjustCreditsInput = Message<"ai.stigmer.billing.v1.AdjustCreditsInput"> & {
+    /**
+     * @generated from field: string org_id = 1;
+     */
+    orgId: string;
+    /**
+     * Positive to add credits, negative to remove.
+     *
+     * @generated from field: int64 amount_micros = 2;
+     */
+    amountMicros: bigint;
+    /**
+     * Human-readable reason for the adjustment (audit trail).
+     *
+     * @generated from field: string reason = 3;
+     */
+    reason: string;
+    /**
+     * Client-supplied deduplication key to prevent double-processing.
+     *
+     * @generated from field: string idempotency_key = 4;
+     */
+    idempotencyKey: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.AdjustCreditsInput.
+ * Use `create(AdjustCreditsInputSchema)` to create a new message.
+ */
+export declare const AdjustCreditsInputSchema: GenMessage<AdjustCreditsInput>;
+/**
+ * AuthorizeExecutionInput requests a credit reservation before execution starts.
+ *
+ * @generated from message ai.stigmer.billing.v1.AuthorizeExecutionInput
+ */
+export type AuthorizeExecutionInput = Message<"ai.stigmer.billing.v1.AuthorizeExecutionInput"> & {
+    /**
+     * @generated from field: string org_id = 1;
+     */
+    orgId: string;
+    /**
+     * @generated from field: string execution_id = 2;
+     */
+    executionId: string;
+    /**
+     * Execution harness ("native" or "cursor").
+     *
+     * @generated from field: string harness = 3;
+     */
+    harness: string;
+    /**
+     * Expected maximum cost. The system may reserve less if balance is limited.
+     *
+     * @generated from field: int64 expected_cost_cap_micros = 4;
+     */
+    expectedCostCapMicros: bigint;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.AuthorizeExecutionInput.
+ * Use `create(AuthorizeExecutionInputSchema)` to create a new message.
+ */
+export declare const AuthorizeExecutionInputSchema: GenMessage<AuthorizeExecutionInput>;
+/**
+ * AuthorizeExecutionResponse indicates whether the execution may proceed.
+ *
+ * @generated from message ai.stigmer.billing.v1.AuthorizeExecutionResponse
+ */
+export type AuthorizeExecutionResponse = Message<"ai.stigmer.billing.v1.AuthorizeExecutionResponse"> & {
+    /**
+     * Whether the execution is authorized to start.
+     *
+     * @generated from field: bool authorized = 1;
+     */
+    authorized: boolean;
+    /**
+     * Reservation ID for tracking. Empty if authorization was denied.
+     *
+     * @generated from field: string reservation_id = 2;
+     */
+    reservationId: string;
+    /**
+     * Micro-USD actually reserved (may be less than requested).
+     *
+     * @generated from field: int64 reserved_micros = 3;
+     */
+    reservedMicros: bigint;
+    /**
+     * Balance available after the reservation was placed.
+     *
+     * @generated from field: int64 available_balance_micros = 4;
+     */
+    availableBalanceMicros: bigint;
+    /**
+     * Reason for denial, if authorized is false.
+     *
+     * @generated from field: string denial_reason = 5;
+     */
+    denialReason: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.AuthorizeExecutionResponse.
+ * Use `create(AuthorizeExecutionResponseSchema)` to create a new message.
+ */
+export declare const AuthorizeExecutionResponseSchema: GenMessage<AuthorizeExecutionResponse>;
+/**
+ * RecordLlmCallUsageInput carries proxy-observed data for a single LLM call.
+ * The billing service computes cost server-side from the model registry —
+ * the caller never provides cost figures.
+ *
+ * Deduplicated by (execution_id, sequence, metering_source).
+ *
+ * @generated from message ai.stigmer.billing.v1.RecordLlmCallUsageInput
+ */
+export type RecordLlmCallUsageInput = Message<"ai.stigmer.billing.v1.RecordLlmCallUsageInput"> & {
+    /**
+     * @generated from field: string execution_id = 1;
+     */
+    executionId: string;
+    /**
+     * 1-based call ordering within the execution.
+     *
+     * @generated from field: int32 sequence = 2;
+     */
+    sequence: number;
+    /**
+     * Provider identifier (e.g., "openai", "anthropic", "cursor").
+     *
+     * @generated from field: string provider = 3;
+     */
+    provider: string;
+    /**
+     * Model as reported by the provider in the response.
+     *
+     * @generated from field: string resolved_model = 4;
+     */
+    resolvedModel: string;
+    /**
+     * Model as requested by the caller (may differ from resolved_model for aliases).
+     *
+     * @generated from field: string requested_model = 5;
+     */
+    requestedModel: string;
+    /**
+     * Token usage extracted from the provider's SSE stream.
+     *
+     * @generated from field: ai.stigmer.agentic.agentexecution.v1.TokenUsage tokens = 6;
+     */
+    tokens?: TokenUsage;
+    /**
+     * Status of usage extraction.
+     *
+     * @generated from field: ai.stigmer.agentic.agentexecution.v1.UsageCompletionStatus usage_status = 7;
+     */
+    usageStatus: UsageCompletionStatus;
+    /**
+     * Provider request ID from response headers.
+     *
+     * @generated from field: string provider_request_id = 8;
+     */
+    providerRequestId: string;
+    /**
+     * HTTP status code from the upstream provider.
+     *
+     * @generated from field: int32 http_status_code = 9;
+     */
+    httpStatusCode: number;
+    /**
+     * Whether the response was streamed (SSE).
+     *
+     * @generated from field: bool streaming = 10;
+     */
+    streaming: boolean;
+    /**
+     * Provider's finish reason (e.g., "end_turn", "stop").
+     *
+     * @generated from field: string finish_reason = 11;
+     */
+    finishReason: string;
+    /**
+     * Proxy-observed timing for this call.
+     *
+     * @generated from field: ai.stigmer.agentic.agentexecution.v1.ProxyTiming proxy_timing = 12;
+     */
+    proxyTiming?: ProxyTiming;
+    /**
+     * Raw provider usage JSON for audit/debug.
+     *
+     * @generated from field: string provider_usage_json = 13;
+     */
+    providerUsageJson: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.RecordLlmCallUsageInput.
+ * Use `create(RecordLlmCallUsageInputSchema)` to create a new message.
+ */
+export declare const RecordLlmCallUsageInputSchema: GenMessage<RecordLlmCallUsageInput>;
+/**
+ * RecordLlmCallUsageResponse returns the cost result so callers can
+ * observe what was recorded without querying separately.
+ *
+ * @generated from message ai.stigmer.billing.v1.RecordLlmCallUsageResponse
+ */
+export type RecordLlmCallUsageResponse = Message<"ai.stigmer.billing.v1.RecordLlmCallUsageResponse"> & {
+    /**
+     * ID of the created LlmCallUsageRecord.
+     *
+     * @generated from field: string usage_record_id = 1;
+     */
+    usageRecordId: string;
+    /**
+     * Provider cost computed server-side from the model registry.
+     *
+     * @generated from field: int64 provider_cost_micros = 2;
+     */
+    providerCostMicros: bigint;
+    /**
+     * Amount debited from customer credits (after markup policy).
+     *
+     * @generated from field: int64 customer_billable_amount_micros = 3;
+     */
+    customerBillableAmountMicros: bigint;
+    /**
+     * Whether this call was billable (complete usage + non-zero cost).
+     *
+     * @generated from field: bool is_billable = 4;
+     */
+    isBillable: boolean;
+    /**
+     * True if this was a duplicate (idempotency key already existed).
+     *
+     * @generated from field: bool is_duplicate = 5;
+     */
+    isDuplicate: boolean;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.RecordLlmCallUsageResponse.
+ * Use `create(RecordLlmCallUsageResponseSchema)` to create a new message.
+ */
+export declare const RecordLlmCallUsageResponseSchema: GenMessage<RecordLlmCallUsageResponse>;
+/**
+ * FinalizeExecutionInput settles the billing for a completed execution.
+ * Releases unused reservation credits and produces the final billing record.
+ *
+ * @generated from message ai.stigmer.billing.v1.FinalizeExecutionInput
+ */
+export type FinalizeExecutionInput = Message<"ai.stigmer.billing.v1.FinalizeExecutionInput"> & {
+    /**
+     * @generated from field: string execution_id = 1;
+     */
+    executionId: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.FinalizeExecutionInput.
+ * Use `create(FinalizeExecutionInputSchema)` to create a new message.
+ */
+export declare const FinalizeExecutionInputSchema: GenMessage<FinalizeExecutionInput>;
+/**
+ * FinalizeExecutionResponse summarizes the execution's billing outcome.
+ *
+ * @generated from message ai.stigmer.billing.v1.FinalizeExecutionResponse
+ */
+export type FinalizeExecutionResponse = Message<"ai.stigmer.billing.v1.FinalizeExecutionResponse"> & {
+    /**
+     * Total provider cost across all LLM calls in the execution.
+     *
+     * @generated from field: int64 total_provider_cost_micros = 1;
+     */
+    totalProviderCostMicros: bigint;
+    /**
+     * Total amount charged to the customer across all LLM calls.
+     *
+     * @generated from field: int64 total_billable_amount_micros = 2;
+     */
+    totalBillableAmountMicros: bigint;
+    /**
+     * Micro-USD released back to available balance from the reservation.
+     *
+     * @generated from field: int64 released_reservation_micros = 3;
+     */
+    releasedReservationMicros: bigint;
+    /**
+     * Number of LLM calls billed in this execution.
+     *
+     * @generated from field: int32 billed_call_count = 4;
+     */
+    billedCallCount: number;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.FinalizeExecutionResponse.
+ * Use `create(FinalizeExecutionResponseSchema)` to create a new message.
+ */
+export declare const FinalizeExecutionResponseSchema: GenMessage<FinalizeExecutionResponse>;
+/**
+ * CreateCreditCheckoutSessionInput initiates a Stripe Checkout purchase
+ * for a credit pack.
+ *
+ * The server creates a Stripe Checkout Session and returns the URL for
+ * the client to redirect the user. The caller's email is resolved from
+ * their identity account for Stripe Customer creation.
+ *
+ * @generated from message ai.stigmer.billing.v1.CreateCreditCheckoutSessionInput
+ */
+export type CreateCreditCheckoutSessionInput = Message<"ai.stigmer.billing.v1.CreateCreditCheckoutSessionInput"> & {
+    /**
+     * @generated from field: string org_id = 1;
+     */
+    orgId: string;
+    /**
+     * Credit pack to purchase (e.g., "starter", "growth", "team").
+     *
+     * @generated from field: string pack_id = 2;
+     */
+    packId: string;
+    /**
+     * URL to redirect to after successful payment.
+     *
+     * @generated from field: string success_url = 3;
+     */
+    successUrl: string;
+    /**
+     * URL to redirect to if the user cancels checkout.
+     *
+     * @generated from field: string cancel_url = 4;
+     */
+    cancelUrl: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.CreateCreditCheckoutSessionInput.
+ * Use `create(CreateCreditCheckoutSessionInputSchema)` to create a new message.
+ */
+export declare const CreateCreditCheckoutSessionInputSchema: GenMessage<CreateCreditCheckoutSessionInput>;
+/**
+ * CreateCreditCheckoutSessionResponse returns the Stripe Checkout URL
+ * and purchase tracking identifiers.
+ *
+ * @generated from message ai.stigmer.billing.v1.CreateCreditCheckoutSessionResponse
+ */
+export type CreateCreditCheckoutSessionResponse = Message<"ai.stigmer.billing.v1.CreateCreditCheckoutSessionResponse"> & {
+    /**
+     * Stripe-hosted checkout page URL. Redirect the user here.
+     *
+     * @generated from field: string checkout_url = 1;
+     */
+    checkoutUrl: string;
+    /**
+     * Internal purchase ID for tracking this transaction.
+     *
+     * @generated from field: string purchase_id = 2;
+     */
+    purchaseId: string;
+    /**
+     * Stripe Checkout Session ID.
+     *
+     * @generated from field: string checkout_session_id = 3;
+     */
+    checkoutSessionId: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.CreateCreditCheckoutSessionResponse.
+ * Use `create(CreateCreditCheckoutSessionResponseSchema)` to create a new message.
+ */
+export declare const CreateCreditCheckoutSessionResponseSchema: GenMessage<CreateCreditCheckoutSessionResponse>;
+/**
+ * CreateBillingPortalSessionInput opens a Stripe Customer Portal session
+ * for payment method management.
+ *
+ * The portal allows the user to add, update, or remove payment methods
+ * without leaving the Stigmer billing flow. The return_url controls where
+ * Stripe redirects after the user finishes.
+ *
+ * @generated from message ai.stigmer.billing.v1.CreateBillingPortalSessionInput
+ */
+export type CreateBillingPortalSessionInput = Message<"ai.stigmer.billing.v1.CreateBillingPortalSessionInput"> & {
+    /**
+     * @generated from field: string org_id = 1;
+     */
+    orgId: string;
+    /**
+     * URL to redirect to after the user exits the Stripe Customer Portal.
+     *
+     * @generated from field: string return_url = 2;
+     */
+    returnUrl: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.CreateBillingPortalSessionInput.
+ * Use `create(CreateBillingPortalSessionInputSchema)` to create a new message.
+ */
+export declare const CreateBillingPortalSessionInputSchema: GenMessage<CreateBillingPortalSessionInput>;
+/**
+ * CreateBillingPortalSessionResponse returns the Stripe-hosted Portal URL.
+ *
+ * @generated from message ai.stigmer.billing.v1.CreateBillingPortalSessionResponse
+ */
+export type CreateBillingPortalSessionResponse = Message<"ai.stigmer.billing.v1.CreateBillingPortalSessionResponse"> & {
+    /**
+     * Stripe Customer Portal URL. Redirect the user here.
+     *
+     * @generated from field: string portal_url = 1;
+     */
+    portalUrl: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.CreateBillingPortalSessionResponse.
+ * Use `create(CreateBillingPortalSessionResponseSchema)` to create a new message.
+ */
+export declare const CreateBillingPortalSessionResponseSchema: GenMessage<CreateBillingPortalSessionResponse>;
+/**
+ * SetAutoRechargeConfigInput configures automatic credit top-up for an org.
+ *
+ * When enabled, the billing system charges the account's saved payment
+ * method whenever the available balance drops below threshold_micros.
+ * The charge amount is fixed per event (recharge_amount_micros), capped
+ * at monthly_cap_micros per calendar month.
+ *
+ * Enabling requires an active account with a saved payment method.
+ * Disabling preserves the configuration for easy re-enablement.
+ *
+ * @generated from message ai.stigmer.billing.v1.SetAutoRechargeConfigInput
+ */
+export type SetAutoRechargeConfigInput = Message<"ai.stigmer.billing.v1.SetAutoRechargeConfigInput"> & {
+    /**
+     * @generated from field: string org_id = 1;
+     */
+    orgId: string;
+    /**
+     * Whether to enable auto-recharge.
+     *
+     * @generated from field: bool enabled = 2;
+     */
+    enabled: boolean;
+    /**
+     * Trigger recharge when available balance drops below this amount.
+     *
+     * @generated from field: int64 threshold_micros = 3;
+     */
+    thresholdMicros: bigint;
+    /**
+     * Fixed amount to charge per recharge event.
+     *
+     * @generated from field: int64 recharge_amount_micros = 4;
+     */
+    rechargeAmountMicros: bigint;
+    /**
+     * Maximum total auto-recharge spend per calendar month.
+     *
+     * @generated from field: int64 monthly_cap_micros = 5;
+     */
+    monthlyCapMicros: bigint;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.SetAutoRechargeConfigInput.
+ * Use `create(SetAutoRechargeConfigInputSchema)` to create a new message.
+ */
+export declare const SetAutoRechargeConfigInputSchema: GenMessage<SetAutoRechargeConfigInput>;
+/**
+ * GetBillingAccountInput retrieves the billing account for an organization.
+ *
+ * @generated from message ai.stigmer.billing.v1.GetBillingAccountInput
+ */
+export type GetBillingAccountInput = Message<"ai.stigmer.billing.v1.GetBillingAccountInput"> & {
+    /**
+     * @generated from field: string org_id = 1;
+     */
+    orgId: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.GetBillingAccountInput.
+ * Use `create(GetBillingAccountInputSchema)` to create a new message.
+ */
+export declare const GetBillingAccountInputSchema: GenMessage<GetBillingAccountInput>;
+/**
+ * GetCreditBalanceInput retrieves just the balance breakdown.
+ *
+ * @generated from message ai.stigmer.billing.v1.GetCreditBalanceInput
+ */
+export type GetCreditBalanceInput = Message<"ai.stigmer.billing.v1.GetCreditBalanceInput"> & {
+    /**
+     * @generated from field: string org_id = 1;
+     */
+    orgId: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.GetCreditBalanceInput.
+ * Use `create(GetCreditBalanceInputSchema)` to create a new message.
+ */
+export declare const GetCreditBalanceInputSchema: GenMessage<GetCreditBalanceInput>;
+/**
+ * GetCreditLedgerInput retrieves paginated ledger entries with optional filters.
+ *
+ * @generated from message ai.stigmer.billing.v1.GetCreditLedgerInput
+ */
+export type GetCreditLedgerInput = Message<"ai.stigmer.billing.v1.GetCreditLedgerInput"> & {
+    /**
+     * @generated from field: string org_id = 1;
+     */
+    orgId: string;
+    /**
+     * Pagination parameters.
+     *
+     * @generated from field: ai.stigmer.commons.rpc.PageInfo page = 2;
+     */
+    page?: PageInfo;
+    /**
+     * Filter to specific entry types. Empty means all types.
+     *
+     * @generated from field: repeated ai.stigmer.billing.v1.LedgerEntryType type_filter = 3;
+     */
+    typeFilter: LedgerEntryType[];
+    /**
+     * Filter to entries on or after this timestamp.
+     *
+     * @generated from field: google.protobuf.Timestamp start_time = 4;
+     */
+    startTime?: Timestamp;
+    /**
+     * Filter to entries on or before this timestamp.
+     *
+     * @generated from field: google.protobuf.Timestamp end_time = 5;
+     */
+    endTime?: Timestamp;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.GetCreditLedgerInput.
+ * Use `create(GetCreditLedgerInputSchema)` to create a new message.
+ */
+export declare const GetCreditLedgerInputSchema: GenMessage<GetCreditLedgerInput>;
+/**
+ * CreditLedgerResponse is a paginated list of ledger entries.
+ *
+ * @generated from message ai.stigmer.billing.v1.CreditLedgerResponse
+ */
+export type CreditLedgerResponse = Message<"ai.stigmer.billing.v1.CreditLedgerResponse"> & {
+    /**
+     * @generated from field: repeated ai.stigmer.billing.v1.CreditLedgerEntry entries = 1;
+     */
+    entries: CreditLedgerEntry[];
+    /**
+     * @generated from field: int32 total_pages = 2;
+     */
+    totalPages: number;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.CreditLedgerResponse.
+ * Use `create(CreditLedgerResponseSchema)` to create a new message.
+ */
+export declare const CreditLedgerResponseSchema: GenMessage<CreditLedgerResponse>;
+/**
+ * GetBillingUsageReportInput requests an aggregated billing usage report.
+ *
+ * @generated from message ai.stigmer.billing.v1.GetBillingUsageReportInput
+ */
+export type GetBillingUsageReportInput = Message<"ai.stigmer.billing.v1.GetBillingUsageReportInput"> & {
+    /**
+     * @generated from field: string org_id = 1;
+     */
+    orgId: string;
+    /**
+     * Start of the reporting period.
+     *
+     * @generated from field: google.protobuf.Timestamp start_time = 2;
+     */
+    startTime?: Timestamp;
+    /**
+     * End of the reporting period.
+     *
+     * @generated from field: google.protobuf.Timestamp end_time = 3;
+     */
+    endTime?: Timestamp;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.GetBillingUsageReportInput.
+ * Use `create(GetBillingUsageReportInputSchema)` to create a new message.
+ */
+export declare const GetBillingUsageReportInputSchema: GenMessage<GetBillingUsageReportInput>;
+/**
+ * BillingUsageReportResponse provides aggregated spend data for the period.
+ *
+ * @generated from message ai.stigmer.billing.v1.BillingUsageReportResponse
+ */
+export type BillingUsageReportResponse = Message<"ai.stigmer.billing.v1.BillingUsageReportResponse"> & {
+    /**
+     * Total provider cost in the period.
+     *
+     * @generated from field: int64 total_provider_cost_micros = 1;
+     */
+    totalProviderCostMicros: bigint;
+    /**
+     * Total amount billed to the customer in the period.
+     *
+     * @generated from field: int64 total_billable_amount_micros = 2;
+     */
+    totalBillableAmountMicros: bigint;
+    /**
+     * Number of executions in the period.
+     *
+     * @generated from field: int32 execution_count = 3;
+     */
+    executionCount: number;
+    /**
+     * Number of LLM calls in the period.
+     *
+     * @generated from field: int32 llm_call_count = 4;
+     */
+    llmCallCount: number;
+    /**
+     * Breakdown by model.
+     *
+     * @generated from field: repeated ai.stigmer.billing.v1.ModelBillingBreakdown model_breakdown = 5;
+     */
+    modelBreakdown: ModelBillingBreakdown[];
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.BillingUsageReportResponse.
+ * Use `create(BillingUsageReportResponseSchema)` to create a new message.
+ */
+export declare const BillingUsageReportResponseSchema: GenMessage<BillingUsageReportResponse>;
+/**
+ * ModelBillingBreakdown aggregates billing data for a single model.
+ *
+ * @generated from message ai.stigmer.billing.v1.ModelBillingBreakdown
+ */
+export type ModelBillingBreakdown = Message<"ai.stigmer.billing.v1.ModelBillingBreakdown"> & {
+    /**
+     * @generated from field: string model = 1;
+     */
+    model: string;
+    /**
+     * @generated from field: string harness = 2;
+     */
+    harness: string;
+    /**
+     * @generated from field: string cost_tier = 3;
+     */
+    costTier: string;
+    /**
+     * @generated from field: int64 provider_cost_micros = 4;
+     */
+    providerCostMicros: bigint;
+    /**
+     * @generated from field: int64 billable_amount_micros = 5;
+     */
+    billableAmountMicros: bigint;
+    /**
+     * @generated from field: int32 call_count = 6;
+     */
+    callCount: number;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.ModelBillingBreakdown.
+ * Use `create(ModelBillingBreakdownSchema)` to create a new message.
+ */
+export declare const ModelBillingBreakdownSchema: GenMessage<ModelBillingBreakdown>;
+/**
+ * GetCustomerModelPricingInput requests the customer-facing price list.
+ *
+ * @generated from message ai.stigmer.billing.v1.GetCustomerModelPricingInput
+ */
+export type GetCustomerModelPricingInput = Message<"ai.stigmer.billing.v1.GetCustomerModelPricingInput"> & {
+    /**
+     * Organization ID. Used to resolve org-specific policy overrides.
+     * When empty, returns default pricing.
+     *
+     * @generated from field: string org_id = 1;
+     */
+    orgId: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.GetCustomerModelPricingInput.
+ * Use `create(GetCustomerModelPricingInputSchema)` to create a new message.
+ */
+export declare const GetCustomerModelPricingInputSchema: GenMessage<GetCustomerModelPricingInput>;
+/**
+ * CustomerModelPricingResponse returns the customer-visible price for each model.
+ *
+ * @generated from message ai.stigmer.billing.v1.CustomerModelPricingResponse
+ */
+export type CustomerModelPricingResponse = Message<"ai.stigmer.billing.v1.CustomerModelPricingResponse"> & {
+    /**
+     * @generated from field: repeated ai.stigmer.billing.v1.CustomerModelPricingEntry entries = 1;
+     */
+    entries: CustomerModelPricingEntry[];
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.CustomerModelPricingResponse.
+ * Use `create(CustomerModelPricingResponseSchema)` to create a new message.
+ */
+export declare const CustomerModelPricingResponseSchema: GenMessage<CustomerModelPricingResponse>;
+/**
+ * CustomerModelPricingEntry is the customer-facing price for one model.
+ *
+ * Prices are in micro-USD per million tokens, with markup already applied.
+ * These are what the customer pays, not what Stigmer pays the provider.
+ *
+ * @generated from message ai.stigmer.billing.v1.CustomerModelPricingEntry
+ */
+export type CustomerModelPricingEntry = Message<"ai.stigmer.billing.v1.CustomerModelPricingEntry"> & {
+    /**
+     * Model identifier matching model-registry.json.
+     *
+     * @generated from field: string model_id = 1;
+     */
+    modelId: string;
+    /**
+     * Human-readable model name.
+     *
+     * @generated from field: string display_name = 2;
+     */
+    displayName: string;
+    /**
+     * LLM provider (e.g., "anthropic", "openai").
+     *
+     * @generated from field: string provider = 3;
+     */
+    provider: string;
+    /**
+     * Execution harness ("native" or "cursor").
+     *
+     * @generated from field: string harness = 4;
+     */
+    harness: string;
+    /**
+     * Model cost tier ("economy", "standard", "premium").
+     *
+     * @generated from field: string cost_tier = 5;
+     */
+    costTier: string;
+    /**
+     * Customer price per million input tokens, in micro-USD.
+     *
+     * @generated from field: int64 input_price_micros_per_million = 6;
+     */
+    inputPriceMicrosPerMillion: bigint;
+    /**
+     * Customer price per million output tokens, in micro-USD.
+     *
+     * @generated from field: int64 output_price_micros_per_million = 7;
+     */
+    outputPriceMicrosPerMillion: bigint;
+    /**
+     * Customer price per million cache write tokens, in micro-USD.
+     *
+     * @generated from field: int64 cache_creation_price_micros_per_million = 8;
+     */
+    cacheCreationPriceMicrosPerMillion: bigint;
+    /**
+     * Customer price per million cache read tokens, in micro-USD.
+     *
+     * @generated from field: int64 cache_read_price_micros_per_million = 9;
+     */
+    cacheReadPriceMicrosPerMillion: bigint;
+    /**
+     * Billing policy that produced these prices.
+     *
+     * @generated from field: string pricing_policy_id = 10;
+     */
+    pricingPolicyId: string;
+    /**
+     * Markup applied, in basis points.
+     *
+     * @generated from field: int32 markup_basis_points = 11;
+     */
+    markupBasisPoints: number;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.CustomerModelPricingEntry.
+ * Use `create(CustomerModelPricingEntrySchema)` to create a new message.
+ */
+export declare const CustomerModelPricingEntrySchema: GenMessage<CustomerModelPricingEntry>;