@stigmer/protos 3.12.3 → 3.12.4

package/ai/stigmer/agentic/workflowinstance/v1/query_pb.d.ts

@@ -9,36 +9,12 @@ export declare const file_ai_stigmer_agentic_workflowinstance_v1_query: GenFile;
 /**
  * WorkflowInstanceQueryController handles read operations for workflow instances.
  *
- * @internal
- * This service provides all query operations following the Command-Query Separation pattern.
- * All RPCs that read state without modifying it go through this controller.
- *
- * Authorization:
- * - get: Requires get permission on the specific instance
- * - getByWorkflow: Authorization handled in handler via FGA query (returns filtered instances)
- * - getByReference: Custom authorization (supports flexible reference lookup)
- *
- * All operations respect owner scope visibility rules (users see only their org/identity resources).
- *
  * @generated from service ai.stigmer.agentic.workflowinstance.v1.WorkflowInstanceQueryController
  */
 export declare const WorkflowInstanceQueryController: GenService<{
     /**
      * Get a single workflow instance by ID.
      *
-     * @internal
-     * Retrieves a specific WorkflowInstance using its unique resource identifier.
-     *
-     * Authorization:
-     * Requires "get" permission on the specific WorkflowInstance.
-     * Field path "value" extracts the resource ID from WorkflowInstanceId wrapper.
-     * Verifies user has access based on:
-     * - Instance owner scope (organization or identity_account)
-     * - User's IAM policies
-     *
-     * Error: PERMISSION_DENIED if user lacks get permission
-     * Error: NOT_FOUND if instance ID doesn't exist
-     *
      * @generated from rpc ai.stigmer.agentic.workflowinstance.v1.WorkflowInstanceQueryController.get
      */
     get: {
@@ -51,20 +27,6 @@ export declare const WorkflowInstanceQueryController: GenService<{
      *
      * Returns a paginated list of instances that reference the given workflow ID.
      *
-     * @internal
-     * Authorization is handled in handler via FGA query for authorized workflow_instance_ids,
-     * then filtered by workflow_id. This ensures users only see instances they have access to,
-     * even if the parent workflow is shared across organizations.
-     *
-     * Filtering:
-     * Results are filtered by:
-     * - User's organization/identity visibility
-     * - IAM policies
-     * - Owner scope rules
-     *
-     * Error: PERMISSION_DENIED if user lacks access to the workflow
-     * Error: NOT_FOUND if workflow_id doesn't exist
-     *
      * @generated from rpc ai.stigmer.agentic.workflowinstance.v1.WorkflowInstanceQueryController.getByWorkflow
      */
     getByWorkflow: {
@@ -75,18 +37,6 @@ export declare const WorkflowInstanceQueryController: GenService<{
     /**
      * Get a workflow instance by reference (ID or slug).
      *
-     * @internal
-     * Custom authorization in handler — checks both direct resource access
-     * and organization-level visibility permissions.
-     *
-     * Supports lookup by:
-     * - ID: {id: "wfi_abc123"}
-     * - Slug: {slug: "prod-deploy"}
-     * - Name: {name: "Production Deploy"}
-     *
-     * Error: PERMISSION_DENIED if user lacks access
-     * Error: NOT_FOUND if reference doesn't resolve to an instance
-     *
      * @generated from rpc ai.stigmer.agentic.workflowinstance.v1.WorkflowInstanceQueryController.getByReference
      */
     getByReference: {

package/ai/stigmer/agentic/workflowinstance/v1/query_pb.js

@@ -14,17 +14,6 @@ export const file_ai_stigmer_agentic_workflowinstance_v1_query = /*@__PURE__*/ f
 /**
  * WorkflowInstanceQueryController handles read operations for workflow instances.
  *
- * @internal
- * This service provides all query operations following the Command-Query Separation pattern.
- * All RPCs that read state without modifying it go through this controller.
- *
- * Authorization:
- * - get: Requires get permission on the specific instance
- * - getByWorkflow: Authorization handled in handler via FGA query (returns filtered instances)
- * - getByReference: Custom authorization (supports flexible reference lookup)
- *
- * All operations respect owner scope visibility rules (users see only their org/identity resources).
- *
  * @generated from service ai.stigmer.agentic.workflowinstance.v1.WorkflowInstanceQueryController
  */
 export const WorkflowInstanceQueryController = /*@__PURE__*/ serviceDesc(file_ai_stigmer_agentic_workflowinstance_v1_query, 0);

package/ai/stigmer/agentic/workflowinstance/v1/query_pb.js.map

@@ -1 +1 @@
-{"version":3,"file":"query_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflowinstance/v1/query_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,0IAA0I;AAC1I,oBAAoB;AAKpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,+CAA+C,EAAE,MAAM,aAAa,CAAC;AAE9E,OAAO,EAAE,8CAA8C,EAAE,MAAM,YAAY,CAAC;AAE5E,OAAO,EAAE,sCAAsC,EAAE,MAAM,uCAAuC,CAAC;AAC/F,OAAO,EAAE,uDAAuD,EAAE,MAAM,wDAAwD,CAAC;AACjI,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AAEvG;;GAEG;AACH,MAAM,CAAC,MAAM,iDAAiD,GAAY,aAAa,CACrF,QAAQ,CAAC,q0BAAq0B,EAAE,CAAC,+CAA+C,EAAE,8CAA8C,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,0CAA0C,CAAC,CAAC,CAAC;AAElkC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAwEvC,aAAa,CAChB,WAAW,CAAC,iDAAiD,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"query_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflowinstance/v1/query_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,0IAA0I;AAC1I,oBAAoB;AAKpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,+CAA+C,EAAE,MAAM,aAAa,CAAC;AAE9E,OAAO,EAAE,8CAA8C,EAAE,MAAM,YAAY,CAAC;AAE5E,OAAO,EAAE,sCAAsC,EAAE,MAAM,uCAAuC,CAAC;AAC/F,OAAO,EAAE,uDAAuD,EAAE,MAAM,wDAAwD,CAAC;AACjI,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AAEvG;;GAEG;AACH,MAAM,CAAC,MAAM,iDAAiD,GAAY,aAAa,CACrF,QAAQ,CAAC,q0BAAq0B,EAAE,CAAC,+CAA+C,EAAE,8CAA8C,EAAE,sCAAsC,EAAE,uDAAuD,EAAE,0CAA0C,CAAC,CAAC,CAAC;AAElkC;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAiCvC,aAAa,CAChB,WAAW,CAAC,iDAAiD,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/agentic/workflowinstance/v1/spec_pb.d.ts

@@ -8,32 +8,12 @@ export declare const file_ai_stigmer_agentic_workflowinstance_v1_spec: GenFile;
 /**
  * WorkflowInstanceSpec defines the configurable properties of a workflow instance.
  *
- * @internal
- * This is the "Instance" layer in the Template→Instance→Execution pattern.
- * It provides stateful configuration with environment bindings and secrets.
- *
- * The spec contains:
- * - A reference to the Workflow template (the orchestration blueprint)
- * - Descriptive metadata for humans
- * - Environment references (layered configuration with secrets)
- *
- * Design Philosophy:
- * WorkflowInstanceSpec separates "what to run" (Workflow) from "how to run it" (Environments).
- * This allows the same Workflow template to be instantiated multiple times with different
- * configurations (dev vs prod, different cloud accounts, different teams).
- *
  * @generated from message ai.stigmer.agentic.workflowinstance.v1.WorkflowInstanceSpec
  */
 export type WorkflowInstanceSpec = Message<"ai.stigmer.agentic.workflowinstance.v1.WorkflowInstanceSpec"> & {
     /**
      * Reference to the Workflow template this instance deploys.
      *
-     * @internal
-     * This links the instance to a reusable orchestration blueprint.
-     * The Workflow defines which AgentInstances to orchestrate and in what order.
-     * Format: Workflow resource ID (e.g., "wfl_abc123")
-     * Validation: Minimum length of 1 character (required field)
-     *
      * @generated from field: string workflow_id = 1;
      */
     workflowId: string;
@@ -49,30 +29,6 @@ export type WorkflowInstanceSpec = Message<"ai.stigmer.agentic.workflowinstance.
      * Environments are merged in declaration order — later entries override
      * earlier ones when keys conflict.
      *
-     * @internal
-     * Environments are layered configuration containers that provide:
-     * - Environment variables (API keys, endpoints, flags)
-     * - Secrets (credentials, tokens, passwords)
-     * - Configuration values (timeouts, limits, settings)
-     *
-     * Example layering:
-     *   [base-env, aws-prod-env, github-team-env]
-     *   └─ base-env: Common settings for all instances
-     *   └─ aws-prod-env: AWS production credentials (overrides base AWS settings)
-     *   └─ github-team-env: Team-specific GitHub tokens (overrides generic tokens)
-     *
-     * Use Cases:
-     * - Single env: [prod-env] - Simple, all config in one place
-     * - Base + specific: [base, prod] - Common config + environment-specific
-     * - Layered: [base, cloud, team] - Base + cloud credentials + team settings
-     *
-     * References use ApiResourceReference which supports:
-     * - By ID: {id: "env_abc123"}
-     * - By slug: {slug: "aws-prod-env"}
-     *
-     * At execution time, the WorkflowExecution runtime merges these environments
-     * and provides the combined configuration to all agents in the workflow.
-     *
      * @generated from field: repeated ai.stigmer.commons.apiresource.ApiResourceReference environment_refs = 3;
      */
     environmentRefs: ApiResourceReference[];

package/ai/stigmer/agentic/workflowinstance/v1/spec_pb.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflowinstance/v1/spec_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,yIAAyI;AACzI,oBAAoB;AAKpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,iDAAiD,EAAE,MAAM,kDAAkD,CAAC;AAErH,OAAO,EAAE,sCAAsC,EAAE,MAAM,uCAAuC,CAAC;AAC/F,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAGxF;;GAEG;AACH,MAAM,CAAC,MAAM,gDAAgD,GAAY,aAAa,CACpF,QAAQ,CAAC,82BAA82B,EAAE,CAAC,iDAAiD,EAAE,sCAAsC,EAAE,0BAA0B,CAAC,CAAC,CAAC;AA4Fp/B;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqC,aAAa,CACvF,WAAW,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC;AAEnE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAN,IAAY,2BAuBX;AAvBD,WAAY,2BAA2B;IACrC;;;;;OAKG;IACH,2FAAe,CAAA;IAEf;;;;OAIG;IACH,mFAAW,CAAA;IAEX;;;;;OAKG;IACH,6FAAgB,CAAA;AAClB,CAAC,EAvBW,2BAA2B,KAA3B,2BAA2B,QAuBtC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAyC,aAAa,CAClG,QAAQ,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"spec_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/workflowinstance/v1/spec_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,yIAAyI;AACzI,oBAAoB;AAKpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,iDAAiD,EAAE,MAAM,kDAAkD,CAAC;AAErH,OAAO,EAAE,sCAAsC,EAAE,MAAM,uCAAuC,CAAC;AAC/F,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAGxF;;GAEG;AACH,MAAM,CAAC,MAAM,gDAAgD,GAAY,aAAa,CACpF,QAAQ,CAAC,82BAA82B,EAAE,CAAC,iDAAiD,EAAE,sCAAsC,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAgDp/B;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqC,aAAa,CACvF,WAAW,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC;AAEnE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAN,IAAY,2BAuBX;AAvBD,WAAY,2BAA2B;IACrC;;;;;OAKG;IACH,2FAAe,CAAA;IAEf;;;;OAIG;IACH,mFAAW,CAAA;IAEX;;;;;OAKG;IACH,6FAAgB,CAAA;AAClB,CAAC,EAvBW,2BAA2B,KAA3B,2BAA2B,QAuBtC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAyC,aAAa,CAClG,QAAQ,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC"}

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

@@ -14,10 +14,6 @@ export declare const BillingCommandController: {
          * Provision or retrieve the billing account for an organization.
          * Idempotent: creates the account on first call, returns existing on subsequent calls.
          *
-         * @internal
-         * Called during org creation or first billing interaction.
-         * Initializes balance to zero with default thresholds.
-         *
          * @generated from rpc ai.stigmer.billing.v1.BillingCommandController.getOrCreateBillingAccount
          */
         readonly getOrCreateBillingAccount: {
@@ -38,14 +34,28 @@ export declare const BillingCommandController: {
             readonly O: any;
             readonly kind: any;
         };
+        /**
+         * Grant promotional credits to an org, optionally expiring (use-it-or-lose-it).
+         * Produces an immutable promotional_credit ledger entry for audit.
+         *
+         * The grant burns before adjustment and purchased credits. When expires_at
+         * is set, any remainder unconsumed at that time is removed from the balance
+         * by the platform's grant-expiry sweep (an expiry_debit ledger entry).
+         * Idempotent: replaying an applied idempotency key returns the original
+         * entry, even after the expiry has passed.
+         *
+         * @generated from rpc ai.stigmer.billing.v1.BillingCommandController.grantCredits
+         */
+        readonly grantCredits: {
+            readonly name: "grantCredits";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
         /**
          * Reserve credits before starting an agent execution.
          * Returns authorization status and reservation details.
          *
-         * @internal
-         * Called by the Temporal workflow before dispatching to the agent runner.
-         * The runner must not start if authorized is false.
-         *
          * @generated from rpc ai.stigmer.billing.v1.BillingCommandController.authorizeExecution
          */
         readonly authorizeExecution: {
@@ -59,10 +69,6 @@ export declare const BillingCommandController: {
          * Computes cost server-side from the model registry, inserts an immutable
          * LlmCallUsageRecord, and debits credits from the execution's reservation.
          *
-         * @internal
-         * Called by the proxy after each LLM SSE stream completes.
-         * Deduplicated by (execution_id, sequence, metering_source).
-         *
          * @generated from rpc ai.stigmer.billing.v1.BillingCommandController.recordLlmCallUsage
          */
         readonly recordLlmCallUsage: {
@@ -75,9 +81,6 @@ export declare const BillingCommandController: {
          * Settle billing for a completed execution.
          * Releases unused reservation credits and produces the final billing record.
          *
-         * @internal
-         * Called by the Temporal workflow after the agent runner completes.
-         *
          * @generated from rpc ai.stigmer.billing.v1.BillingCommandController.finalizeExecution
          */
         readonly finalizeExecution: {

package/ai/stigmer/billing/v1/command_connect.js

@@ -2,7 +2,7 @@
 // @generated from file ai/stigmer/billing/v1/command.proto (package ai.stigmer.billing.v1, syntax proto3)
 /* eslint-disable */
 // @ts-nocheck
-import { AdjustCreditsInput, AuthorizeExecutionInput, AuthorizeExecutionResponse, CreateBillingPortalSessionInput, CreateBillingPortalSessionResponse, CreateCreditCheckoutSessionInput, CreateCreditCheckoutSessionResponse, DecideModelPricingOverrideInput, FinalizeExecutionInput, FinalizeExecutionResponse, GetOrCreateBillingAccountInput, RecordLlmCallUsageInput, RecordLlmCallUsageResponse, RetireModelPricingBaselineInput, SetAutoRechargeConfigInput, UpsertModelPricingBaselineInput } from "./io_pbjs";
+import { AdjustCreditsInput, AuthorizeExecutionInput, AuthorizeExecutionResponse, CreateBillingPortalSessionInput, CreateBillingPortalSessionResponse, CreateCreditCheckoutSessionInput, CreateCreditCheckoutSessionResponse, DecideModelPricingOverrideInput, FinalizeExecutionInput, FinalizeExecutionResponse, GetOrCreateBillingAccountInput, GrantCreditsInput, RecordLlmCallUsageInput, RecordLlmCallUsageResponse, RetireModelPricingBaselineInput, SetAutoRechargeConfigInput, UpsertModelPricingBaselineInput } from "./io_pbjs";
 import { BillingAccount } from "./billing_account_pbjs";
 import { MethodKind } from "@bufbuild/protobuf";
 import { CreditLedgerEntry } from "./credit_pbjs";
@@ -24,10 +24,6 @@ export const BillingCommandController = {
          * Provision or retrieve the billing account for an organization.
          * Idempotent: creates the account on first call, returns existing on subsequent calls.
          *
-         * @internal
-         * Called during org creation or first billing interaction.
-         * Initializes balance to zero with default thresholds.
-         *
          * @generated from rpc ai.stigmer.billing.v1.BillingCommandController.getOrCreateBillingAccount
          */
         getOrCreateBillingAccount: {
@@ -48,14 +44,28 @@ export const BillingCommandController = {
             O: CreditLedgerEntry,
             kind: MethodKind.Unary,
         },
+        /**
+         * Grant promotional credits to an org, optionally expiring (use-it-or-lose-it).
+         * Produces an immutable promotional_credit ledger entry for audit.
+         *
+         * The grant burns before adjustment and purchased credits. When expires_at
+         * is set, any remainder unconsumed at that time is removed from the balance
+         * by the platform's grant-expiry sweep (an expiry_debit ledger entry).
+         * Idempotent: replaying an applied idempotency key returns the original
+         * entry, even after the expiry has passed.
+         *
+         * @generated from rpc ai.stigmer.billing.v1.BillingCommandController.grantCredits
+         */
+        grantCredits: {
+            name: "grantCredits",
+            I: GrantCreditsInput,
+            O: CreditLedgerEntry,
+            kind: MethodKind.Unary,
+        },
         /**
          * Reserve credits before starting an agent execution.
          * Returns authorization status and reservation details.
          *
-         * @internal
-         * Called by the Temporal workflow before dispatching to the agent runner.
-         * The runner must not start if authorized is false.
-         *
          * @generated from rpc ai.stigmer.billing.v1.BillingCommandController.authorizeExecution
          */
         authorizeExecution: {
@@ -69,10 +79,6 @@ export const BillingCommandController = {
          * Computes cost server-side from the model registry, inserts an immutable
          * LlmCallUsageRecord, and debits credits from the execution's reservation.
          *
-         * @internal
-         * Called by the proxy after each LLM SSE stream completes.
-         * Deduplicated by (execution_id, sequence, metering_source).
-         *
          * @generated from rpc ai.stigmer.billing.v1.BillingCommandController.recordLlmCallUsage
          */
         recordLlmCallUsage: {
@@ -85,9 +91,6 @@ export const BillingCommandController = {
          * Settle billing for a completed execution.
          * Releases unused reservation credits and produces the final billing record.
          *
-         * @internal
-         * Called by the Temporal workflow after the agent runner completes.
-         *
          * @generated from rpc ai.stigmer.billing.v1.BillingCommandController.finalizeExecution
          */
         finalizeExecution: {

package/ai/stigmer/billing/v1/command_connect.js.map

@@ -1 +1 @@
-{"version":3,"file":"command_connect.js","sourceRoot":"","sources":["../../../../../ai/stigmer/billing/v1/command_connect.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command_connect.js","sourceRoot":"","sources":["../../../../../ai/stigmer/billing/v1/command_connect.ts"],"names":[],"mappings":"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"}

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

@@ -1,7 +1,7 @@
 import type { GenFile, GenService } from "@bufbuild/protobuf/codegenv1";
 import type { BillingAccountSchema } from "./billing_account_pb.js";
 import type { CreditLedgerEntrySchema } from "./credit_pb.js";
-import type { AdjustCreditsInputSchema, AuthorizeExecutionInputSchema, AuthorizeExecutionResponseSchema, CreateBillingPortalSessionInputSchema, CreateBillingPortalSessionResponseSchema, CreateCreditCheckoutSessionInputSchema, CreateCreditCheckoutSessionResponseSchema, DecideModelPricingOverrideInputSchema, FinalizeExecutionInputSchema, FinalizeExecutionResponseSchema, GetOrCreateBillingAccountInputSchema, RecordLlmCallUsageInputSchema, RecordLlmCallUsageResponseSchema, RetireModelPricingBaselineInputSchema, SetAutoRechargeConfigInputSchema, UpsertModelPricingBaselineInputSchema } from "./io_pb.js";
+import type { AdjustCreditsInputSchema, AuthorizeExecutionInputSchema, AuthorizeExecutionResponseSchema, CreateBillingPortalSessionInputSchema, CreateBillingPortalSessionResponseSchema, CreateCreditCheckoutSessionInputSchema, CreateCreditCheckoutSessionResponseSchema, DecideModelPricingOverrideInputSchema, FinalizeExecutionInputSchema, FinalizeExecutionResponseSchema, GetOrCreateBillingAccountInputSchema, GrantCreditsInputSchema, RecordLlmCallUsageInputSchema, RecordLlmCallUsageResponseSchema, RetireModelPricingBaselineInputSchema, SetAutoRechargeConfigInputSchema, UpsertModelPricingBaselineInputSchema } from "./io_pb.js";
 import type { ModelPricingBaselineSchema } from "./model_pricing_baseline_pb.js";
 import type { ModelPricingOverrideSchema } from "./pricing_override_pb.js";
 /**
@@ -22,10 +22,6 @@ export declare const BillingCommandController: GenService<{
      * Provision or retrieve the billing account for an organization.
      * Idempotent: creates the account on first call, returns existing on subsequent calls.
      *
-     * @internal
-     * Called during org creation or first billing interaction.
-     * Initializes balance to zero with default thresholds.
-     *
      * @generated from rpc ai.stigmer.billing.v1.BillingCommandController.getOrCreateBillingAccount
      */
     getOrCreateBillingAccount: {
@@ -44,14 +40,27 @@ export declare const BillingCommandController: GenService<{
         input: typeof AdjustCreditsInputSchema;
         output: typeof CreditLedgerEntrySchema;
     };
+    /**
+     * Grant promotional credits to an org, optionally expiring (use-it-or-lose-it).
+     * Produces an immutable promotional_credit ledger entry for audit.
+     *
+     * The grant burns before adjustment and purchased credits. When expires_at
+     * is set, any remainder unconsumed at that time is removed from the balance
+     * by the platform's grant-expiry sweep (an expiry_debit ledger entry).
+     * Idempotent: replaying an applied idempotency key returns the original
+     * entry, even after the expiry has passed.
+     *
+     * @generated from rpc ai.stigmer.billing.v1.BillingCommandController.grantCredits
+     */
+    grantCredits: {
+        methodKind: "unary";
+        input: typeof GrantCreditsInputSchema;
+        output: typeof CreditLedgerEntrySchema;
+    };
     /**
      * Reserve credits before starting an agent execution.
      * Returns authorization status and reservation details.
      *
-     * @internal
-     * Called by the Temporal workflow before dispatching to the agent runner.
-     * The runner must not start if authorized is false.
-     *
      * @generated from rpc ai.stigmer.billing.v1.BillingCommandController.authorizeExecution
      */
     authorizeExecution: {
@@ -64,10 +73,6 @@ export declare const BillingCommandController: GenService<{
      * Computes cost server-side from the model registry, inserts an immutable
      * LlmCallUsageRecord, and debits credits from the execution's reservation.
      *
-     * @internal
-     * Called by the proxy after each LLM SSE stream completes.
-     * Deduplicated by (execution_id, sequence, metering_source).
-     *
      * @generated from rpc ai.stigmer.billing.v1.BillingCommandController.recordLlmCallUsage
      */
     recordLlmCallUsage: {
@@ -79,9 +84,6 @@ export declare const BillingCommandController: GenService<{
      * Settle billing for a completed execution.
      * Releases unused reservation credits and produces the final billing record.
      *
-     * @internal
-     * Called by the Temporal workflow after the agent runner completes.
-     *
      * @generated from rpc ai.stigmer.billing.v1.BillingCommandController.finalizeExecution
      */
     finalizeExecution: {

package/ai/stigmer/billing/v1/command_pb.js

@@ -11,7 +11,7 @@ import { file_ai_stigmer_commons_rpc_method_options } from "../../commons/rpc/me
 /**
  * Describes the file ai/stigmer/billing/v1/command.proto.
  */
-export const file_ai_stigmer_billing_v1_command = /*@__PURE__*/ fileDesc("CiNhaS9zdGlnbWVyL2JpbGxpbmcvdjEvY29tbWFuZC5wcm90bxIVYWkuc3RpZ21lci5iaWxsaW5nLnYxMssRChhCaWxsaW5nQ29tbWFuZENvbnRyb2xsZXISwQEKGWdldE9yQ3JlYXRlQmlsbGluZ0FjY291bnQSNS5haS5zdGlnbWVyLmJpbGxpbmcudjEuR2V0T3JDcmVhdGVCaWxsaW5nQWNjb3VudElucHV0GiUuYWkuc3RpZ21lci5iaWxsaW5nLnYxLkJpbGxpbmdBY2NvdW50IkbCuBhCCBwQHiIGb3JnX2lkKjR1bmF1dGhvcml6ZWQgdG8gbWFuYWdlIGJpbGxpbmcgZm9yIHRoaXMgb3JnYW5pemF0aW9uEqwBCg1hZGp1c3RDcmVkaXRzEikuYWkuc3RpZ21lci5iaWxsaW5nLnYxLkFkanVzdENyZWRpdHNJbnB1dBooLmFpLnN0aWdtZXIuYmlsbGluZy52MS5DcmVkaXRMZWRnZXJFbnRyeSJGwrgYQggcEB4iBm9yZ19pZCo0dW5hdXRob3JpemVkIHRvIGFkanVzdCBjcmVkaXRzIGZvciB0aGlzIG9yZ2FuaXphdGlvbhLCAQoSYXV0aG9yaXplRXhlY3V0aW9uEi4uYWkuc3RpZ21lci5iaWxsaW5nLnYxLkF1dGhvcml6ZUV4ZWN1dGlvbklucHV0GjEuYWkuc3RpZ21lci5iaWxsaW5nLnYxLkF1dGhvcml6ZUV4ZWN1dGlvblJlc3BvbnNlIknCuBhFCB0QHyo2b25seSBwbGF0Zm9ybSBvcGVyYXRvcnMgY2FuIGV4ZWN1dGUgYmlsbGluZyBvcGVyYXRpb25zMgdzdGlnbWVyEsIBChJyZWNvcmRMbG1DYWxsVXNhZ2USLi5haS5zdGlnbWVyLmJpbGxpbmcudjEuUmVjb3JkTGxtQ2FsbFVzYWdlSW5wdXQaMS5haS5zdGlnbWVyLmJpbGxpbmcudjEuUmVjb3JkTGxtQ2FsbFVzYWdlUmVzcG9uc2UiScK4GEUIHRAfKjZvbmx5IHBsYXRmb3JtIG9wZXJhdG9ycyBjYW4gZXhlY3V0ZSBiaWxsaW5nIG9wZXJhdGlvbnMyB3N0aWdtZXISvwEKEWZpbmFsaXplRXhlY3V0aW9uEi0uYWkuc3RpZ21lci5iaWxsaW5nLnYxLkZpbmFsaXplRXhlY3V0aW9uSW5wdXQaMC5haS5zdGlnbWVyLmJpbGxpbmcudjEuRmluYWxpemVFeGVjdXRpb25SZXNwb25zZSJJwrgYRQgdEB8qNm9ubHkgcGxhdGZvcm0gb3BlcmF0b3JzIGNhbiBleGVjdXRlIGJpbGxpbmcgb3BlcmF0aW9uczIHc3RpZ21lchLcAQobY3JlYXRlQ3JlZGl0Q2hlY2tvdXRTZXNzaW9uEjcuYWkuc3RpZ21lci5iaWxsaW5nLnYxLkNyZWF0ZUNyZWRpdENoZWNrb3V0U2Vzc2lvbklucHV0GjouYWkuc3RpZ21lci5iaWxsaW5nLnYxLkNyZWF0ZUNyZWRpdENoZWNrb3V0U2Vzc2lvblJlc3BvbnNlIkjCuBhECBwQHiIGb3JnX2lkKjZ1bmF1dGhvcml6ZWQgdG8gcHVyY2hhc2UgY3JlZGl0cyBmb3IgdGhpcyBvcmdhbml6YXRpb24S1wEKGmNyZWF0ZUJpbGxpbmdQb3J0YWxTZXNzaW9uEjYuYWkuc3RpZ21lci5iaWxsaW5nLnYxLkNyZWF0ZUJpbGxpbmdQb3J0YWxTZXNzaW9uSW5wdXQaOS5haS5zdGlnbWVyLmJpbGxpbmcudjEuQ3JlYXRlQmlsbGluZ1BvcnRhbFNlc3Npb25SZXNwb25zZSJGwrgYQggcEB4iBm9yZ19pZCo0dW5hdXRob3JpemVkIHRvIG1hbmFnZSBiaWxsaW5nIGZvciB0aGlzIG9yZ2FuaXphdGlvbhK/AQoVc2V0QXV0b1JlY2hhcmdlQ29uZmlnEjEuYWkuc3RpZ21lci5iaWxsaW5nLnYxLlNldEF1dG9SZWNoYXJnZUNvbmZpZ0lucHV0GiUuYWkuc3RpZ21lci5iaWxsaW5nLnYxLkJpbGxpbmdBY2NvdW50IkzCuBhICBwQHiIGb3JnX2lkKjp1bmF1dGhvcml6ZWQgdG8gbWFuYWdlIGF1dG8tcmVjaGFyZ2UgZm9yIHRoaXMgb3JnYW5pemF0aW9uEsoBChpkZWNpZGVNb2RlbFByaWNpbmdPdmVycmlkZRI2LmFpLnN0aWdtZXIuYmlsbGluZy52MS5EZWNpZGVNb2RlbFByaWNpbmdPdmVycmlkZUlucHV0GisuYWkuc3RpZ21lci5iaWxsaW5nLnYxLk1vZGVsUHJpY2luZ092ZXJyaWRlIkfCuBhDCCAQHyo0b25seSBwbGF0Zm9ybSBvcGVyYXRvcnMgY2FuIGRlY2lkZSBwcmljaW5nIG92ZXJyaWRlczIHc3RpZ21lchLSAQoadXBzZXJ0TW9kZWxQcmljaW5nQmFzZWxpbmUSNi5haS5zdGlnbWVyLmJpbGxpbmcudjEuVXBzZXJ0TW9kZWxQcmljaW5nQmFzZWxpbmVJbnB1dBorLmFpLnN0aWdtZXIuYmlsbGluZy52MS5Nb2RlbFByaWNpbmdCYXNlbGluZSJPwrgYSwggEB8qPG9ubHkgcGxhdGZvcm0gb3BlcmF0b3JzIGNhbiBlZGl0IHRoZSBtb2RlbCByZWdpc3RyeSBiYXNlbGluZTIHc3RpZ21lchLSAQoacmV0aXJlTW9kZWxQcmljaW5nQmFzZWxpbmUSNi5haS5zdGlnbWVyLmJpbGxpbmcudjEuUmV0aXJlTW9kZWxQcmljaW5nQmFzZWxpbmVJbnB1dBorLmFpLnN0aWdtZXIuYmlsbGluZy52MS5Nb2RlbFByaWNpbmdCYXNlbGluZSJPwrgYSwggEB8qPG9ubHkgcGxhdGZvcm0gb3BlcmF0b3JzIGNhbiBlZGl0IHRoZSBtb2RlbCByZWdpc3RyeSBiYXNlbGluZTIHc3RpZ21lcmIGcHJvdG8z", [file_ai_stigmer_billing_v1_billing_account, file_ai_stigmer_billing_v1_credit, file_ai_stigmer_billing_v1_io, file_ai_stigmer_billing_v1_model_pricing_baseline, file_ai_stigmer_billing_v1_pricing_override, file_ai_stigmer_commons_rpc_method_options]);
+export const file_ai_stigmer_billing_v1_command = /*@__PURE__*/ fileDesc("CiNhaS9zdGlnbWVyL2JpbGxpbmcvdjEvY29tbWFuZC5wcm90bxIVYWkuc3RpZ21lci5iaWxsaW5nLnYxMvcSChhCaWxsaW5nQ29tbWFuZENvbnRyb2xsZXISwQEKGWdldE9yQ3JlYXRlQmlsbGluZ0FjY291bnQSNS5haS5zdGlnbWVyLmJpbGxpbmcudjEuR2V0T3JDcmVhdGVCaWxsaW5nQWNjb3VudElucHV0GiUuYWkuc3RpZ21lci5iaWxsaW5nLnYxLkJpbGxpbmdBY2NvdW50IkbCuBhCCBwQHiIGb3JnX2lkKjR1bmF1dGhvcml6ZWQgdG8gbWFuYWdlIGJpbGxpbmcgZm9yIHRoaXMgb3JnYW5pemF0aW9uEqwBCg1hZGp1c3RDcmVkaXRzEikuYWkuc3RpZ21lci5iaWxsaW5nLnYxLkFkanVzdENyZWRpdHNJbnB1dBooLmFpLnN0aWdtZXIuYmlsbGluZy52MS5DcmVkaXRMZWRnZXJFbnRyeSJGwrgYQggcEB4iBm9yZ19pZCo0dW5hdXRob3JpemVkIHRvIGFkanVzdCBjcmVkaXRzIGZvciB0aGlzIG9yZ2FuaXphdGlvbhKpAQoMZ3JhbnRDcmVkaXRzEiguYWkuc3RpZ21lci5iaWxsaW5nLnYxLkdyYW50Q3JlZGl0c0lucHV0GiguYWkuc3RpZ21lci5iaWxsaW5nLnYxLkNyZWRpdExlZGdlckVudHJ5IkXCuBhBCBwQHiIGb3JnX2lkKjN1bmF1dGhvcml6ZWQgdG8gZ3JhbnQgY3JlZGl0cyBmb3IgdGhpcyBvcmdhbml6YXRpb24SwgEKEmF1dGhvcml6ZUV4ZWN1dGlvbhIuLmFpLnN0aWdtZXIuYmlsbGluZy52MS5BdXRob3JpemVFeGVjdXRpb25JbnB1dBoxLmFpLnN0aWdtZXIuYmlsbGluZy52MS5BdXRob3JpemVFeGVjdXRpb25SZXNwb25zZSJJwrgYRQgdEB8qNm9ubHkgcGxhdGZvcm0gb3BlcmF0b3JzIGNhbiBleGVjdXRlIGJpbGxpbmcgb3BlcmF0aW9uczIHc3RpZ21lchLCAQoScmVjb3JkTGxtQ2FsbFVzYWdlEi4uYWkuc3RpZ21lci5iaWxsaW5nLnYxLlJlY29yZExsbUNhbGxVc2FnZUlucHV0GjEuYWkuc3RpZ21lci5iaWxsaW5nLnYxLlJlY29yZExsbUNhbGxVc2FnZVJlc3BvbnNlIknCuBhFCB0QHyo2b25seSBwbGF0Zm9ybSBvcGVyYXRvcnMgY2FuIGV4ZWN1dGUgYmlsbGluZyBvcGVyYXRpb25zMgdzdGlnbWVyEr8BChFmaW5hbGl6ZUV4ZWN1dGlvbhItLmFpLnN0aWdtZXIuYmlsbGluZy52MS5GaW5hbGl6ZUV4ZWN1dGlvbklucHV0GjAuYWkuc3RpZ21lci5iaWxsaW5nLnYxLkZpbmFsaXplRXhlY3V0aW9uUmVzcG9uc2UiScK4GEUIHRAfKjZvbmx5IHBsYXRmb3JtIG9wZXJhdG9ycyBjYW4gZXhlY3V0ZSBiaWxsaW5nIG9wZXJhdGlvbnMyB3N0aWdtZXIS3AEKG2NyZWF0ZUNyZWRpdENoZWNrb3V0U2Vzc2lvbhI3LmFpLnN0aWdtZXIuYmlsbGluZy52MS5DcmVhdGVDcmVkaXRDaGVja291dFNlc3Npb25JbnB1dBo6LmFpLnN0aWdtZXIuYmlsbGluZy52MS5DcmVhdGVDcmVkaXRDaGVja291dFNlc3Npb25SZXNwb25zZSJIwrgYRAgcEB4iBm9yZ19pZCo2dW5hdXRob3JpemVkIHRvIHB1cmNoYXNlIGNyZWRpdHMgZm9yIHRoaXMgb3JnYW5pemF0aW9uEtcBChpjcmVhdGVCaWxsaW5nUG9ydGFsU2Vzc2lvbhI2LmFpLnN0aWdtZXIuYmlsbGluZy52MS5DcmVhdGVCaWxsaW5nUG9ydGFsU2Vzc2lvbklucHV0GjkuYWkuc3RpZ21lci5iaWxsaW5nLnYxLkNyZWF0ZUJpbGxpbmdQb3J0YWxTZXNzaW9uUmVzcG9uc2UiRsK4GEIIHBAeIgZvcmdfaWQqNHVuYXV0aG9yaXplZCB0byBtYW5hZ2UgYmlsbGluZyBmb3IgdGhpcyBvcmdhbml6YXRpb24SvwEKFXNldEF1dG9SZWNoYXJnZUNvbmZpZxIxLmFpLnN0aWdtZXIuYmlsbGluZy52MS5TZXRBdXRvUmVjaGFyZ2VDb25maWdJbnB1dBolLmFpLnN0aWdtZXIuYmlsbGluZy52MS5CaWxsaW5nQWNjb3VudCJMwrgYSAgcEB4iBm9yZ19pZCo6dW5hdXRob3JpemVkIHRvIG1hbmFnZSBhdXRvLXJlY2hhcmdlIGZvciB0aGlzIG9yZ2FuaXphdGlvbhLKAQoaZGVjaWRlTW9kZWxQcmljaW5nT3ZlcnJpZGUSNi5haS5zdGlnbWVyLmJpbGxpbmcudjEuRGVjaWRlTW9kZWxQcmljaW5nT3ZlcnJpZGVJbnB1dBorLmFpLnN0aWdtZXIuYmlsbGluZy52MS5Nb2RlbFByaWNpbmdPdmVycmlkZSJHwrgYQwggEB8qNG9ubHkgcGxhdGZvcm0gb3BlcmF0b3JzIGNhbiBkZWNpZGUgcHJpY2luZyBvdmVycmlkZXMyB3N0aWdtZXIS0gEKGnVwc2VydE1vZGVsUHJpY2luZ0Jhc2VsaW5lEjYuYWkuc3RpZ21lci5iaWxsaW5nLnYxLlVwc2VydE1vZGVsUHJpY2luZ0Jhc2VsaW5lSW5wdXQaKy5haS5zdGlnbWVyLmJpbGxpbmcudjEuTW9kZWxQcmljaW5nQmFzZWxpbmUiT8K4GEsIIBAfKjxvbmx5IHBsYXRmb3JtIG9wZXJhdG9ycyBjYW4gZWRpdCB0aGUgbW9kZWwgcmVnaXN0cnkgYmFzZWxpbmUyB3N0aWdtZXIS0gEKGnJldGlyZU1vZGVsUHJpY2luZ0Jhc2VsaW5lEjYuYWkuc3RpZ21lci5iaWxsaW5nLnYxLlJldGlyZU1vZGVsUHJpY2luZ0Jhc2VsaW5lSW5wdXQaKy5haS5zdGlnbWVyLmJpbGxpbmcudjEuTW9kZWxQcmljaW5nQmFzZWxpbmUiT8K4GEsIIBAfKjxvbmx5IHBsYXRmb3JtIG9wZXJhdG9ycyBjYW4gZWRpdCB0aGUgbW9kZWwgcmVnaXN0cnkgYmFzZWxpbmUyB3N0aWdtZXJiBnByb3RvMw", [file_ai_stigmer_billing_v1_billing_account, file_ai_stigmer_billing_v1_credit, file_ai_stigmer_billing_v1_io, file_ai_stigmer_billing_v1_model_pricing_baseline, file_ai_stigmer_billing_v1_pricing_override, file_ai_stigmer_commons_rpc_method_options]);
 /**
  * BillingCommandController handles write operations for the billing bounded context.
  *

package/ai/stigmer/billing/v1/command_pb.js.map

@@ -1 +1 @@
-{"version":3,"file":"command_pb.js","sourceRoot":"","sources":["../../../../../ai/stigmer/billing/v1/command_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,0GAA0G;AAC1G,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,0CAA0C,EAAE,MAAM,yBAAyB,CAAC;AAErF,OAAO,EAAE,iCAAiC,EAAE,MAAM,gBAAgB,CAAC;AAEnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAE3D,OAAO,EAAE,iDAAiD,EAAE,MAAM,gCAAgC,CAAC;AAEnG,OAAO,EAAE,2CAA2C,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,0CAA0C,EAAE,MAAM,wCAAwC,CAAC;AAEpG;;GAEG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAY,aAAa,CACtE,QAAQ,CAAC,0hGAA0hG,EAAE,CAAC,0CAA0C,EAAE,iCAAiC,EAAE,6BAA6B,EAAE,iDAAiD,EAAE,2CAA2C,EAAE,0CAA0C,CAAC,CAAC,CAAC;AAEnyG;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GA0JhC,aAAa,CAChB,WAAW,CAAC,kCAAkC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"command_pb.js","sourceRoot":"","sources":["../../../../../ai/stigmer/billing/v1/command_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,0GAA0G;AAC1G,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,0CAA0C,EAAE,MAAM,yBAAyB,CAAC;AAErF,OAAO,EAAE,iCAAiC,EAAE,MAAM,gBAAgB,CAAC;AAEnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAE3D,OAAO,EAAE,iDAAiD,EAAE,MAAM,gCAAgC,CAAC;AAEnG,OAAO,EAAE,2CAA2C,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,0CAA0C,EAAE,MAAM,wCAAwC,CAAC;AAEpG;;GAEG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAY,aAAa,CACtE,QAAQ,CAAC,gwGAAgwG,EAAE,CAAC,0CAA0C,EAAE,iCAAiC,EAAE,6BAA6B,EAAE,iDAAiD,EAAE,2CAA2C,EAAE,0CAA0C,CAAC,CAAC,CAAC;AAEzgH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GA4JhC,aAAa,CAChB,WAAW,CAAC,kCAAkC,EAAE,CAAC,CAAC,CAAC"}

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

@@ -62,6 +62,58 @@ export type AdjustCreditsInput = Message<"ai.stigmer.billing.v1.AdjustCreditsInp
  * Use `create(AdjustCreditsInputSchema)` to create a new message.
  */
 export declare const AdjustCreditsInputSchema: GenMessage<AdjustCreditsInput>;
+/**
+ * GrantCreditsInput creates a promotional credit grant, optionally expiring.
+ *
+ * Unlike adjustCredits (a signed balance adjustment), a grant is strictly
+ * positive and carries use-it-or-lose-it semantics when expires_at is set:
+ * the grant is consumed before adjustment and purchased credits (promotional
+ * burn order), and whatever remains unconsumed at expiry is removed from the
+ * balance with an expiry_debit ledger entry.
+ *
+ * @generated from message ai.stigmer.billing.v1.GrantCreditsInput
+ */
+export type GrantCreditsInput = Message<"ai.stigmer.billing.v1.GrantCreditsInput"> & {
+    /**
+     * @generated from field: string org_id = 1;
+     */
+    orgId: string;
+    /**
+     * Amount to grant. Must be positive; grants never remove credits.
+     *
+     * @generated from field: int64 amount_micros = 2;
+     */
+    amountMicros: bigint;
+    /**
+     * When the grant expires. Unset means the grant never expires.
+     *
+     * Must be in the future when the grant is created. Deliberately NOT
+     * enforced structurally: a replay of an already-applied idempotency key
+     * always returns the original ledger entry, even if the expiry has since
+     * passed — late retries of a successful grant must never fail. Expiry
+     * precision is whole seconds; sub-second precision is discarded.
+     *
+     * @generated from field: google.protobuf.Timestamp expires_at = 3;
+     */
+    expiresAt?: Timestamp;
+    /**
+     * Human-readable reason for the grant (audit trail).
+     *
+     * @generated from field: string reason = 4;
+     */
+    reason: string;
+    /**
+     * Client-supplied deduplication key to prevent double-processing.
+     *
+     * @generated from field: string idempotency_key = 5;
+     */
+    idempotencyKey: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.GrantCreditsInput.
+ * Use `create(GrantCreditsInputSchema)` to create a new message.
+ */
+export declare const GrantCreditsInputSchema: GenMessage<GrantCreditsInput>;
 /**
  * AuthorizeExecutionInput requests a credit reservation before execution starts.
  *
@@ -254,6 +306,20 @@ export type RecordLlmCallUsageInput = Message<"ai.stigmer.billing.v1.RecordLlmCa
      * @generated from field: ai.stigmer.agentic.agentexecution.v1.CursorKeySource cursor_key_source = 17;
      */
     cursorKeySource: CursorKeySource;
+    /**
+     * Provider-reported service tier that actually served this call
+     * (native harness, stigmer/stigmer#361): Anthropic reports it in the
+     * response usage ("standard" | "priority" | "batch"), OpenAI at the
+     * response top level ("default" | "flex" | "priority"). Reported
+     * verbatim by the proxy from the SSE stream — the wire truth billing
+     * reconciles against the execution's REQUESTED tier (the
+     * service_tier.mismatch counter). Empty when the provider reported
+     * none, and for cursor-harness calls, whose billed variant arrives
+     * through the cursor path's pricing-variant resolution instead.
+     *
+     * @generated from field: string served_service_tier = 18;
+     */
+    servedServiceTier: string;
 };
 /**
  * Describes the message ai.stigmer.billing.v1.RecordLlmCallUsageInput.