@stigmer/protos 0.3.3 → 0.4.0

package/ai/stigmer/agentic/agentexecution/v1/usage_pb.js

@@ -1,24 +1,286 @@
 // @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
 // @generated from file ai/stigmer/agentic/agentexecution/v1/usage.proto (package ai.stigmer.agentic.agentexecution.v1, syntax proto3)
 /* eslint-disable */
-import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { enumDesc, fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
 /**
  * Describes the file ai/stigmer/agentic/agentexecution/v1/usage.proto.
  */
-export const file_ai_stigmer_agentic_agentexecution_v1_usage = /*@__PURE__*/ fileDesc("CjBhaS9zdGlnbWVyL2FnZW50aWMvYWdlbnRleGVjdXRpb24vdjEvdXNhZ2UucHJvdG8SJGFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MSKfBAoMVXNhZ2VNZXRyaWNzEhUKDXByb21wdF90b2tlbnMYASABKAUSGQoRY29tcGxldGlvbl90b2tlbnMYAiABKAUSFAoMdG90YWxfdG9rZW5zGAMgASgFEhYKDmxsbV9jYWxsX2NvdW50GAQgASgFEhUKDXByaW1hcnlfbW9kZWwYBSABKAkSHQoVY2FjaGVfY3JlYXRpb25fdG9rZW5zGAYgASgFEhkKEWNhY2hlX3JlYWRfdG9rZW5zGAcgASgFEkkKD21vZGVsX2JyZWFrZG93bhgIIAMoCzIwLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5Nb2RlbFVzYWdlEhoKEmVzdGltYXRlZF9jb3N0X3VzZBgJIAEoARIjCht0b29sX3Jlc3VsdF9jaGFyc190cnVuY2F0ZWQYCiABKAMSRwoJbGxtX2NhbGxzGAsgAygLMjQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkxsbUNhbGxNZXRyaWNzEhkKEXRvdGFsX2R1cmF0aW9uX21zGAwgASgFEhcKD2xsbV9kdXJhdGlvbl9tcxgNIAEoBRIYChB0b29sX2R1cmF0aW9uX21zGA4gASgFEiEKGWFwcHJvdmFsX3dhaXRfZHVyYXRpb25fbXMYDyABKAUSGAoQcHJpbWFyeV9wcm92aWRlchgQIAEoCSLXAgoKTW9kZWxVc2FnZRINCgVtb2RlbBgBIAEoCRIQCghwcm92aWRlchgCIAEoCRIUCgxpbnB1dF90b2tlbnMYAyABKAUSFQoNb3V0cHV0X3Rva2VucxgEIAEoBRIdChVjYWNoZV9jcmVhdGlvbl90b2tlbnMYBSABKAUSGQoRY2FjaGVfcmVhZF90b2tlbnMYBiABKAUSEgoKY2FsbF9jb3VudBgHIAEoBRIfChdpbnB1dF9wcmljZV9wZXJfbWlsbGlvbhgIIAEoARIgChhvdXRwdXRfcHJpY2VfcGVyX21pbGxpb24YCSABKAESKAogY2FjaGVfY3JlYXRpb25fcHJpY2VfcGVyX21pbGxpb24YCiABKAESJAocY2FjaGVfcmVhZF9wcmljZV9wZXJfbWlsbGlvbhgLIAEoARIaChJlc3RpbWF0ZWRfY29zdF91c2QYDCABKAEihAIKDkxsbUNhbGxNZXRyaWNzEhAKCHNlcXVlbmNlGAEgASgFEg0KBW1vZGVsGAIgASgJEhAKCHByb3ZpZGVyGAMgASgJEhQKDGlucHV0X3Rva2VucxgEIAEoBRIVCg1vdXRwdXRfdG9rZW5zGAUgASgFEh0KFWNhY2hlX2NyZWF0aW9uX3Rva2VucxgGIAEoBRIZChFjYWNoZV9yZWFkX3Rva2VucxgHIAEoBRIaChJlc3RpbWF0ZWRfY29zdF91c2QYCCABKAESEwoLZHVyYXRpb25fbXMYCSABKAUSEQoJdGltZXN0YW1wGAogASgJEhQKDHRvdGFsX3Rva2VucxgLIAEoBWIGcHJvdG8z");
+export const file_ai_stigmer_agentic_agentexecution_v1_usage = /*@__PURE__*/ fileDesc("CjBhaS9zdGlnbWVyL2FnZW50aWMvYWdlbnRleGVjdXRpb24vdjEvdXNhZ2UucHJvdG8SJGFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MSKxAwoKVG9rZW5Vc2FnZRIUCgxpbnB1dF90b2tlbnMYASABKAMSFQoNb3V0cHV0X3Rva2VucxgCIAEoAxIUCgx0b3RhbF90b2tlbnMYAyABKAMSIwobY2FjaGVfY3JlYXRpb25faW5wdXRfdG9rZW5zGAQgASgDEh8KF2NhY2hlX3JlYWRfaW5wdXRfdG9rZW5zGAUgASgDEhgKEHJlYXNvbmluZ190b2tlbnMYBiABKAMSHgoWdG9vbF91c2VfcHJvbXB0X3Rva2VucxgHIAEoAxIaChJhdWRpb19pbnB1dF90b2tlbnMYCCABKAMSGwoTYXVkaW9fb3V0cHV0X3Rva2VucxgJIAEoAxJqChZwcm92aWRlcl90b2tlbl9kZXRhaWxzGBQgAygLMkouYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLlRva2VuVXNhZ2UuUHJvdmlkZXJUb2tlbkRldGFpbHNFbnRyeRo7ChlQcm92aWRlclRva2VuRGV0YWlsc0VudHJ5EgsKA2tleRgBIAEoCRINCgV2YWx1ZRgCIAEoAzoCOAEijAMKD1ByaWNpbmdTbmFwc2hvdBIgChhwcmljaW5nX3JlZ2lzdHJ5X3ZlcnNpb24YASABKAkSOAoUcHJpY2luZ19lZmZlY3RpdmVfYXQYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEhAKCGN1cnJlbmN5GAMgASgJEiYKHmlucHV0X3ByaWNlX21pY3Jvc19wZXJfbWlsbGlvbhgKIAEoAxInCh9vdXRwdXRfcHJpY2VfbWljcm9zX3Blcl9taWxsaW9uGAsgASgDEi8KJ2NhY2hlX2NyZWF0aW9uX3ByaWNlX21pY3Jvc19wZXJfbWlsbGlvbhgMIAEoAxIrCiNjYWNoZV9yZWFkX3ByaWNlX21pY3Jvc19wZXJfbWlsbGlvbhgNIAEoAxIqCiJyZWFzb25pbmdfcHJpY2VfbWljcm9zX3Blcl9taWxsaW9uGA4gASgDEh0KFW1hcmt1cF9wb2xpY3lfdmVyc2lvbhgeIAEoCRIRCgljb3N0X3RpZXIYHyABKAkihQIKCUNvc3RTdGFtcBIQCghjdXJyZW5jeRgBIAEoCRIcChRwcm92aWRlcl9jb3N0X21pY3JvcxgCIAEoAxInCh9jdXN0b21lcl9iaWxsYWJsZV9hbW91bnRfbWljcm9zGAMgASgDElcKEmNhbGN1bGF0aW9uX3N0YXR1cxgEIAEoDjI7LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5Db3N0Q2FsY3VsYXRpb25TdGF0dXMSRgoHcHJpY2luZxgFIAEoCzI1LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5QcmljaW5nU25hcHNob3Qi1AMKC1Byb3h5VGltaW5nEjUKEXByb3h5X3JlY2VpdmVkX2F0GAEgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI/Cht1cHN0cmVhbV9yZXF1ZXN0X3N0YXJ0ZWRfYXQYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEjoKFmZpcnN0X3Jlc3BvbnNlX2J5dGVfYXQYAyABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEjkKFWxhc3RfcmVzcG9uc2VfYnl0ZV9hdBgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASNgoScHJveHlfY29tcGxldGVkX2F0GAUgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIYChB1cHN0cmVhbV90dGZiX21zGAogASgDEhgKEHVwc3RyZWFtX3R0bGJfbXMYCyABKAMSGgoSc3RyZWFtX2R1cmF0aW9uX21zGAwgASgDEh8KF3Byb3h5X3RvdGFsX2R1cmF0aW9uX21zGA0gASgDEhUKDXJlcXVlc3RfYnl0ZXMYFCABKAMSFgoOcmVzcG9uc2VfYnl0ZXMYFSABKAMi+gEKC0JpbGxpbmdMaW5rEk4KDGRlYml0X3N0YXR1cxgBIAEoDjI4LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5CaWxsaW5nRGViaXRTdGF0dXMSFgoOcmVzZXJ2YXRpb25faWQYAiABKAkSGAoQYmlsbGluZ19kZWJpdF9pZBgDIAEoCRIuCgpkZWJpdGVkX2F0GAQgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIdChViaWxsaW5nX2F0dGVtcHRfY291bnQYBSABKAUSGgoSbGFzdF9iaWxsaW5nX2Vycm9yGAYgASgJItcJChJMbG1DYWxsVXNhZ2VSZWNvcmQSFwoPdXNhZ2VfcmVjb3JkX2lkGAEgASgJEhQKDGV4ZWN1dGlvbl9pZBgCIAEoCRIZChFyb290X2V4ZWN1dGlvbl9pZBgDIAEoCRIQCghzZXF1ZW5jZRgEIAEoBRIXCg9pZGVtcG90ZW5jeV9rZXkYBSABKAkSHgoWY2Fub25pY2FsX3BheWxvYWRfaGFzaBgGIAEoCRIvCgtvYnNlcnZlZF9hdBgKIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASLgoKY3JlYXRlZF9hdBgLIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASUgoPbWV0ZXJpbmdfc291cmNlGBQgASgOMjkuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLlVzYWdlTWV0ZXJpbmdTb3VyY2USSgoLdHJ1c3RfbGV2ZWwYFSABKA4yNS5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuVXNhZ2VUcnVzdExldmVsElEKDHVzYWdlX3N0YXR1cxgWIAEoDjI7LmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5Vc2FnZUNvbXBsZXRpb25TdGF0dXMSEwoLaXNfYmlsbGFibGUYFyABKAgSEAoIcHJvdmlkZXIYHiABKAkSFwoPcmVxdWVzdGVkX21vZGVsGB8gASgJEhYKDnJlc29sdmVkX21vZGVsGCAgASgJEhAKCGVuZHBvaW50GCEgASgJEhEKCXN0cmVhbWluZxgiIAEoCBIUCgxzZXJ2aWNlX3RpZXIYIyABKAkSGwoTcHJvdmlkZXJfcmVxdWVzdF9pZBgkIAEoCRIPCgdoYXJuZXNzGCUgASgJEhgKEGh0dHBfc3RhdHVzX2NvZGUYKCABKAUSFQoNZmluaXNoX3JlYXNvbhgpIAEoCRISCgplcnJvcl9jb2RlGCogASgJEkAKBnRva2VucxgyIAEoCzIwLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5Ub2tlblVzYWdlEj0KBGNvc3QYMyABKAsyLy5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuQ29zdFN0YW1wEkcKDHByb3h5X3RpbWluZxg8IAEoCzIxLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5Qcm94eVRpbWluZxIbChNwcm92aWRlcl91c2FnZV9qc29uGEYgASgJEkIKB2JpbGxpbmcYUCABKAsyMS5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuQmlsbGluZ0xpbmsSDgoGb3JnX2lkGAcgASgJEhIKCnNlc3Npb25faWQYCCABKAkSVAoGbGFiZWxzGFogAygLMkQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkxsbUNhbGxVc2FnZVJlY29yZC5MYWJlbHNFbnRyeRotCgtMYWJlbHNFbnRyeRILCgNrZXkYASABKAkSDQoFdmFsdWUYAiABKAk6AjgBIr4CChRVc2FnZVJlcG9ydEFnZ3JlZ2F0ZRIUCgxpbnB1dF90b2tlbnMYASABKAMSFQoNb3V0cHV0X3Rva2VucxgCIAEoAxIUCgx0b3RhbF90b2tlbnMYAyABKAMSIwobY2FjaGVfY3JlYXRpb25faW5wdXRfdG9rZW5zGAQgASgDEh8KF2NhY2hlX3JlYWRfaW5wdXRfdG9rZW5zGAUgASgDEhgKEHJlYXNvbmluZ190b2tlbnMYBiABKAMSFgoObGxtX2NhbGxfY291bnQYCiABKAUSHAoUYmlsbGFibGVfY29zdF9taWNyb3MYFCABKAMSHAoUcHJvdmlkZXJfY29zdF9taWNyb3MYFSABKAMSFQoNcHJpbWFyeV9tb2RlbBgeIAEoCRIYChBwcmltYXJ5X3Byb3ZpZGVyGB8gASgJIvABCgpNb2RlbFVzYWdlEg0KBW1vZGVsGAEgASgJEhAKCHByb3ZpZGVyGAIgASgJEhQKDGlucHV0X3Rva2VucxgDIAEoAxIVCg1vdXRwdXRfdG9rZW5zGAQgASgDEiMKG2NhY2hlX2NyZWF0aW9uX2lucHV0X3Rva2VucxgFIAEoAxIfChdjYWNoZV9yZWFkX2lucHV0X3Rva2VucxgGIAEoAxISCgpjYWxsX2NvdW50GAcgASgFEhwKFGJpbGxhYmxlX2Nvc3RfbWljcm9zGAggASgDEhwKFHByb3ZpZGVyX2Nvc3RfbWljcm9zGAkgASgDKq4CChNVc2FnZU1ldGVyaW5nU291cmNlEiUKIVVTQUdFX01FVEVSSU5HX1NPVVJDRV9VTlNQRUNJRklFRBAAEjEKLVVTQUdFX01FVEVSSU5HX1NPVVJDRV9QUk9YWV9QUk9WSURFUl9SRVBPUlRFRBABEjYKMlVTQUdFX01FVEVSSU5HX1NPVVJDRV9SVU5ORVJfUFJPVklERVJfUkVQT1JURURfT1NTEAISIwofVVNBR0VfTUVURVJJTkdfU09VUkNFX0VTVElNQVRFRBADEjMKL1VTQUdFX01FVEVSSU5HX1NPVVJDRV9QUk9WSURFUl9BRE1JTl9SRUNPTkNJTEVEEAQSKwonVVNBR0VfTUVURVJJTkdfU09VUkNFX01BTlVBTF9BREpVU1RNRU5UEAUqqAEKD1VzYWdlVHJ1c3RMZXZlbBIhCh1VU0FHRV9UUlVTVF9MRVZFTF9VTlNQRUNJRklFRBAAEicKI1VTQUdFX1RSVVNUX0xFVkVMX0JJTExJTkdfQVVUSE9SSVRZEAESJQohVVNBR0VfVFJVU1RfTEVWRUxfU0VSVkVSX09CU0VSVkVEEAISIgoeVVNBR0VfVFJVU1RfTEVWRUxfRElTUExBWV9PTkxZEAMq/AIKFVVzYWdlQ29tcGxldGlvblN0YXR1cxInCiNVU0FHRV9DT01QTEVUSU9OX1NUQVRVU19VTlNQRUNJRklFRBAAEiQKIFVTQUdFX0NPTVBMRVRJT05fU1RBVFVTX0NPTVBMRVRFEAESLgoqVVNBR0VfQ09NUExFVElPTl9TVEFUVVNfU1RSRUFNX0lOVEVSUlVQVEVEEAISNQoxVVNBR0VfQ09NUExFVElPTl9TVEFUVVNfUFJPVklERVJfRVJST1JfV0lUSF9VU0FHRRADEjMKL1VTQUdFX0NPTVBMRVRJT05fU1RBVFVTX1BST1ZJREVSX0VSUk9SX05PX1VTQUdFEAQSKgomVVNBR0VfQ09NUExFVElPTl9TVEFUVVNfRVNUSU1BVEVEX09OTFkQBRImCiJVU0FHRV9DT01QTEVUSU9OX1NUQVRVU19SRUNPTkNJTEVEEAYSJAogVVNBR0VfQ09NUExFVElPTl9TVEFUVVNfQ09ORkxJQ1QQByqfAgoSQmlsbGluZ0RlYml0U3RhdHVzEiQKIEJJTExJTkdfREVCSVRfU1RBVFVTX1VOU1BFQ0lGSUVEEAASJwojQklMTElOR19ERUJJVF9TVEFUVVNfTk9UX0FQUExJQ0FCTEUQARIgChxCSUxMSU5HX0RFQklUX1NUQVRVU19QRU5ESU5HEAISIAocQklMTElOR19ERUJJVF9TVEFUVVNfREVCSVRFRBADEikKJUJJTExJTkdfREVCSVRfU1RBVFVTX0ZBSUxFRF9SRVRSWUFCTEUQBBIoCiRCSUxMSU5HX0RFQklUX1NUQVRVU19GQUlMRURfVEVSTUlOQUwQBRIhCh1CSUxMSU5HX0RFQklUX1NUQVRVU19DT05GTElDVBAGKo8CChVDb3N0Q2FsY3VsYXRpb25TdGF0dXMSJwojQ09TVF9DQUxDVUxBVElPTl9TVEFUVVNfVU5TUEVDSUZJRUQQABIkCiBDT1NUX0NBTENVTEFUSU9OX1NUQVRVU19DT01QVVRFRBABEiUKIUNPU1RfQ0FMQ1VMQVRJT05fU1RBVFVTX0VTVElNQVRFRBACEisKJ0NPU1RfQ0FMQ1VMQVRJT05fU1RBVFVTX1BSSUNFX05PVF9GT1VORBADEiYKIkNPU1RfQ0FMQ1VMQVRJT05fU1RBVFVTX1JFQ09OQ0lMRUQQBBIrCidDT1NUX0NBTENVTEFUSU9OX1NUQVRVU19NQU5VQUxfQURKVVNURUQQBWIGcHJvdG8z", [file_google_protobuf_timestamp]);
 /**
- * Describes the message ai.stigmer.agentic.agentexecution.v1.UsageMetrics.
- * Use `create(UsageMetricsSchema)` to create a new message.
+ * Describes the message ai.stigmer.agentic.agentexecution.v1.TokenUsage.
+ * Use `create(TokenUsageSchema)` to create a new message.
  */
-export const UsageMetricsSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_agentexecution_v1_usage, 0);
+export const TokenUsageSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_agentexecution_v1_usage, 0);
+/**
+ * Describes the message ai.stigmer.agentic.agentexecution.v1.PricingSnapshot.
+ * Use `create(PricingSnapshotSchema)` to create a new message.
+ */
+export const PricingSnapshotSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_agentexecution_v1_usage, 1);
+/**
+ * Describes the message ai.stigmer.agentic.agentexecution.v1.CostStamp.
+ * Use `create(CostStampSchema)` to create a new message.
+ */
+export const CostStampSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_agentexecution_v1_usage, 2);
+/**
+ * Describes the message ai.stigmer.agentic.agentexecution.v1.ProxyTiming.
+ * Use `create(ProxyTimingSchema)` to create a new message.
+ */
+export const ProxyTimingSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_agentexecution_v1_usage, 3);
+/**
+ * Describes the message ai.stigmer.agentic.agentexecution.v1.BillingLink.
+ * Use `create(BillingLinkSchema)` to create a new message.
+ */
+export const BillingLinkSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_agentexecution_v1_usage, 4);
+/**
+ * Describes the message ai.stigmer.agentic.agentexecution.v1.LlmCallUsageRecord.
+ * Use `create(LlmCallUsageRecordSchema)` to create a new message.
+ */
+export const LlmCallUsageRecordSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_agentexecution_v1_usage, 5);
+/**
+ * Describes the message ai.stigmer.agentic.agentexecution.v1.UsageReportAggregate.
+ * Use `create(UsageReportAggregateSchema)` to create a new message.
+ */
+export const UsageReportAggregateSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_agentexecution_v1_usage, 6);
 /**
  * Describes the message ai.stigmer.agentic.agentexecution.v1.ModelUsage.
  * Use `create(ModelUsageSchema)` to create a new message.
  */
-export const ModelUsageSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_agentexecution_v1_usage, 1);
+export const ModelUsageSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_agentexecution_v1_usage, 7);
+/**
+ * Identifies who wrote the usage record and under what conditions.
+ *
+ * @generated from enum ai.stigmer.agentic.agentexecution.v1.UsageMeteringSource
+ */
+export var UsageMeteringSource;
+(function (UsageMeteringSource) {
+    /**
+     * @generated from enum value: USAGE_METERING_SOURCE_UNSPECIFIED = 0;
+     */
+    UsageMeteringSource[UsageMeteringSource["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * Cloud mode: Stigmer proxy observed provider-reported final usage from SSE stream.
+     *
+     * @generated from enum value: USAGE_METERING_SOURCE_PROXY_PROVIDER_REPORTED = 1;
+     */
+    UsageMeteringSource[UsageMeteringSource["PROXY_PROVIDER_REPORTED"] = 1] = "PROXY_PROVIDER_REPORTED";
+    /**
+     * OSS/BYOK mode: runner reports provider response usage directly.
+     *
+     * @generated from enum value: USAGE_METERING_SOURCE_RUNNER_PROVIDER_REPORTED_OSS = 2;
+     */
+    UsageMeteringSource[UsageMeteringSource["RUNNER_PROVIDER_REPORTED_OSS"] = 2] = "RUNNER_PROVIDER_REPORTED_OSS";
+    /**
+     * Estimate from tokenizer/preflight/local accounting. Never billing-authoritative in cloud mode.
+     *
+     * @generated from enum value: USAGE_METERING_SOURCE_ESTIMATED = 3;
+     */
+    UsageMeteringSource[UsageMeteringSource["ESTIMATED"] = 3] = "ESTIMATED";
+    /**
+     * Reconciliation from provider admin usage/cost reports.
+     *
+     * @generated from enum value: USAGE_METERING_SOURCE_PROVIDER_ADMIN_RECONCILED = 4;
+     */
+    UsageMeteringSource[UsageMeteringSource["PROVIDER_ADMIN_RECONCILED"] = 4] = "PROVIDER_ADMIN_RECONCILED";
+    /**
+     * Human/system manual adjustment.
+     *
+     * @generated from enum value: USAGE_METERING_SOURCE_MANUAL_ADJUSTMENT = 5;
+     */
+    UsageMeteringSource[UsageMeteringSource["MANUAL_ADJUSTMENT"] = 5] = "MANUAL_ADJUSTMENT";
+})(UsageMeteringSource || (UsageMeteringSource = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.agentexecution.v1.UsageMeteringSource.
+ */
+export const UsageMeteringSourceSchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_agentexecution_v1_usage, 0);
+/**
+ * Declares what the record can be used for.
+ *
+ * @generated from enum ai.stigmer.agentic.agentexecution.v1.UsageTrustLevel
+ */
+export var UsageTrustLevel;
+(function (UsageTrustLevel) {
+    /**
+     * @generated from enum value: USAGE_TRUST_LEVEL_UNSPECIFIED = 0;
+     */
+    UsageTrustLevel[UsageTrustLevel["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * Billing-authoritative: safe to debit credits from.
+     *
+     * @generated from enum value: USAGE_TRUST_LEVEL_BILLING_AUTHORITY = 1;
+     */
+    UsageTrustLevel[UsageTrustLevel["BILLING_AUTHORITY"] = 1] = "BILLING_AUTHORITY";
+    /**
+     * Server-observed but not billing (e.g., proxy timing).
+     *
+     * @generated from enum value: USAGE_TRUST_LEVEL_SERVER_OBSERVED = 2;
+     */
+    UsageTrustLevel[UsageTrustLevel["SERVER_OBSERVED"] = 2] = "SERVER_OBSERVED";
+    /**
+     * Display-only: runner-reported, never used for billing.
+     *
+     * @generated from enum value: USAGE_TRUST_LEVEL_DISPLAY_ONLY = 3;
+     */
+    UsageTrustLevel[UsageTrustLevel["DISPLAY_ONLY"] = 3] = "DISPLAY_ONLY";
+})(UsageTrustLevel || (UsageTrustLevel = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.agentexecution.v1.UsageTrustLevel.
+ */
+export const UsageTrustLevelSchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_agentexecution_v1_usage, 1);
+/**
+ * Status of provider-reported token usage extraction.
+ *
+ * @generated from enum ai.stigmer.agentic.agentexecution.v1.UsageCompletionStatus
+ */
+export var UsageCompletionStatus;
+(function (UsageCompletionStatus) {
+    /**
+     * @generated from enum value: USAGE_COMPLETION_STATUS_UNSPECIFIED = 0;
+     */
+    UsageCompletionStatus[UsageCompletionStatus["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * Provider reported complete final usage (normal case).
+     *
+     * @generated from enum value: USAGE_COMPLETION_STATUS_COMPLETE = 1;
+     */
+    UsageCompletionStatus[UsageCompletionStatus["COMPLETE"] = 1] = "COMPLETE";
+    /**
+     * Stream ended without final usage event (e.g., connection interrupted).
+     *
+     * @generated from enum value: USAGE_COMPLETION_STATUS_STREAM_INTERRUPTED = 2;
+     */
+    UsageCompletionStatus[UsageCompletionStatus["STREAM_INTERRUPTED"] = 2] = "STREAM_INTERRUPTED";
+    /**
+     * Provider returned error but included partial usage data.
+     *
+     * @generated from enum value: USAGE_COMPLETION_STATUS_PROVIDER_ERROR_WITH_USAGE = 3;
+     */
+    UsageCompletionStatus[UsageCompletionStatus["PROVIDER_ERROR_WITH_USAGE"] = 3] = "PROVIDER_ERROR_WITH_USAGE";
+    /**
+     * Provider returned error with no usage data.
+     *
+     * @generated from enum value: USAGE_COMPLETION_STATUS_PROVIDER_ERROR_NO_USAGE = 4;
+     */
+    UsageCompletionStatus[UsageCompletionStatus["PROVIDER_ERROR_NO_USAGE"] = 4] = "PROVIDER_ERROR_NO_USAGE";
+    /**
+     * Usage is estimated (tokenizer/preflight), not provider-reported.
+     *
+     * @generated from enum value: USAGE_COMPLETION_STATUS_ESTIMATED_ONLY = 5;
+     */
+    UsageCompletionStatus[UsageCompletionStatus["ESTIMATED_ONLY"] = 5] = "ESTIMATED_ONLY";
+    /**
+     * Reconciled against provider admin reports.
+     *
+     * @generated from enum value: USAGE_COMPLETION_STATUS_RECONCILED = 6;
+     */
+    UsageCompletionStatus[UsageCompletionStatus["RECONCILED"] = 6] = "RECONCILED";
+    /**
+     * Conflict: retry with different payload detected.
+     *
+     * @generated from enum value: USAGE_COMPLETION_STATUS_CONFLICT = 7;
+     */
+    UsageCompletionStatus[UsageCompletionStatus["CONFLICT"] = 7] = "CONFLICT";
+})(UsageCompletionStatus || (UsageCompletionStatus = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.agentexecution.v1.UsageCompletionStatus.
+ */
+export const UsageCompletionStatusSchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_agentexecution_v1_usage, 2);
+/**
+ * Status of the billing debit for a usage record.
+ *
+ * @generated from enum ai.stigmer.agentic.agentexecution.v1.BillingDebitStatus
+ */
+export var BillingDebitStatus;
+(function (BillingDebitStatus) {
+    /**
+     * @generated from enum value: BILLING_DEBIT_STATUS_UNSPECIFIED = 0;
+     */
+    BillingDebitStatus[BillingDebitStatus["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * No billing applicable (e.g., OSS mode, $0 cost, incomplete usage).
+     *
+     * @generated from enum value: BILLING_DEBIT_STATUS_NOT_APPLICABLE = 1;
+     */
+    BillingDebitStatus[BillingDebitStatus["NOT_APPLICABLE"] = 1] = "NOT_APPLICABLE";
+    /**
+     * Debit pending (usage written, billing not yet attempted).
+     *
+     * @generated from enum value: BILLING_DEBIT_STATUS_PENDING = 2;
+     */
+    BillingDebitStatus[BillingDebitStatus["PENDING"] = 2] = "PENDING";
+    /**
+     * Credits successfully debited.
+     *
+     * @generated from enum value: BILLING_DEBIT_STATUS_DEBITED = 3;
+     */
+    BillingDebitStatus[BillingDebitStatus["DEBITED"] = 3] = "DEBITED";
+    /**
+     * Debit failed but retryable (transient error).
+     *
+     * @generated from enum value: BILLING_DEBIT_STATUS_FAILED_RETRYABLE = 4;
+     */
+    BillingDebitStatus[BillingDebitStatus["FAILED_RETRYABLE"] = 4] = "FAILED_RETRYABLE";
+    /**
+     * Debit failed terminally (e.g., no reservation found).
+     *
+     * @generated from enum value: BILLING_DEBIT_STATUS_FAILED_TERMINAL = 5;
+     */
+    BillingDebitStatus[BillingDebitStatus["FAILED_TERMINAL"] = 5] = "FAILED_TERMINAL";
+    /**
+     * Conflict detected (duplicate with different payload).
+     *
+     * @generated from enum value: BILLING_DEBIT_STATUS_CONFLICT = 6;
+     */
+    BillingDebitStatus[BillingDebitStatus["CONFLICT"] = 6] = "CONFLICT";
+})(BillingDebitStatus || (BillingDebitStatus = {}));
+/**
+ * Describes the enum ai.stigmer.agentic.agentexecution.v1.BillingDebitStatus.
+ */
+export const BillingDebitStatusSchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_agentexecution_v1_usage, 3);
+/**
+ * Status of cost calculation for a usage record.
+ *
+ * @generated from enum ai.stigmer.agentic.agentexecution.v1.CostCalculationStatus
+ */
+export var CostCalculationStatus;
+(function (CostCalculationStatus) {
+    /**
+     * @generated from enum value: COST_CALCULATION_STATUS_UNSPECIFIED = 0;
+     */
+    CostCalculationStatus[CostCalculationStatus["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * Cost computed from pricing registry at write time.
+     *
+     * @generated from enum value: COST_CALCULATION_STATUS_COMPUTED = 1;
+     */
+    CostCalculationStatus[CostCalculationStatus["COMPUTED"] = 1] = "COMPUTED";
+    /**
+     * Cost is an estimate (model not found in registry).
+     *
+     * @generated from enum value: COST_CALCULATION_STATUS_ESTIMATED = 2;
+     */
+    CostCalculationStatus[CostCalculationStatus["ESTIMATED"] = 2] = "ESTIMATED";
+    /**
+     * Model pricing not found; cost is zero.
+     *
+     * @generated from enum value: COST_CALCULATION_STATUS_PRICE_NOT_FOUND = 3;
+     */
+    CostCalculationStatus[CostCalculationStatus["PRICE_NOT_FOUND"] = 3] = "PRICE_NOT_FOUND";
+    /**
+     * Cost was reconciled against provider reports.
+     *
+     * @generated from enum value: COST_CALCULATION_STATUS_RECONCILED = 4;
+     */
+    CostCalculationStatus[CostCalculationStatus["RECONCILED"] = 4] = "RECONCILED";
+    /**
+     * Cost was manually adjusted.
+     *
+     * @generated from enum value: COST_CALCULATION_STATUS_MANUAL_ADJUSTED = 5;
+     */
+    CostCalculationStatus[CostCalculationStatus["MANUAL_ADJUSTED"] = 5] = "MANUAL_ADJUSTED";
+})(CostCalculationStatus || (CostCalculationStatus = {}));
 /**
- * Describes the message ai.stigmer.agentic.agentexecution.v1.LlmCallMetrics.
- * Use `create(LlmCallMetricsSchema)` to create a new message.
+ * Describes the enum ai.stigmer.agentic.agentexecution.v1.CostCalculationStatus.
  */
-export const LlmCallMetricsSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_agentexecution_v1_usage, 2);
+export const CostCalculationStatusSchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_agentic_agentexecution_v1_usage, 4);
 //# sourceMappingURL=usage_pb.js.map

package/ai/stigmer/agentic/agentexecution/v1/usage_pb.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agentexecution/v1/usage_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,sIAAsI;AACtI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAGrE;;GAEG;AACH,MAAM,CAAC,MAAM,+CAA+C,GAAY,aAAa,CACnF,QAAQ,CAAC,soDAAsoD,CAAC,CAAC;AA4MnpD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,aAAa,CACvE,WAAW,CAAC,+CAA+C,EAAE,CAAC,CAAC,CAAC;AAuIlE;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA2B,aAAa,CACnE,WAAW,CAAC,+CAA+C,EAAE,CAAC,CAAC,CAAC;AA0GlE;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+B,aAAa,CAC3E,WAAW,CAAC,+CAA+C,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"usage_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agentexecution/v1/usage_pb.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,245 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { BillingAccountStatus } from "./enum_pb.js";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/billing/v1/billing_account.proto.
+ */
+export declare const file_ai_stigmer_billing_v1_billing_account: GenFile;
+/**
+ * BillingAccount is the billing aggregate for an organization.
+ *
+ * Exactly one BillingAccount exists per org, auto-provisioned on first
+ * billing interaction. It tracks credit balances, Stripe customer mapping,
+ * and auto-recharge configuration.
+ *
+ * This is not a standard Stigmer API Resource — it has no api_version/kind
+ * envelope, no slug, and no blueprint/runtime split. Authorization is scoped
+ * to the parent organization via can_view_billing / can_manage_billing.
+ *
+ * @generated from message ai.stigmer.billing.v1.BillingAccount
+ */
+export type BillingAccount = Message<"ai.stigmer.billing.v1.BillingAccount"> & {
+    /**
+     * Unique identifier for the billing account.
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * Organization that owns this billing account.
+     *
+     * @generated from field: string org_id = 2;
+     */
+    orgId: string;
+    /**
+     * Current lifecycle status.
+     *
+     * @generated from field: ai.stigmer.billing.v1.BillingAccountStatus status = 3;
+     */
+    status: BillingAccountStatus;
+    /**
+     * Real-time credit balance breakdown.
+     *
+     * @generated from field: ai.stigmer.billing.v1.CreditBalance balance = 4;
+     */
+    balance?: CreditBalance;
+    /**
+     * User-configurable automatic recharge settings.
+     *
+     * @generated from field: ai.stigmer.billing.v1.AutoRechargeConfig auto_recharge = 5;
+     */
+    autoRecharge?: AutoRechargeConfig;
+    /**
+     * Stripe Customer ID. Empty until the org's first Stripe interaction.
+     *
+     * @generated from field: string stripe_customer_id = 6;
+     */
+    stripeCustomerId: string;
+    /**
+     * Maximum negative balance allowed before hard-stopping executions.
+     * Free orgs: 0. Paid orgs: typically 2_000_000 ($2.00). Enterprise: contract-specific.
+     *
+     * @generated from field: int64 allowed_negative_balance_micros = 7;
+     */
+    allowedNegativeBalanceMicros: bigint;
+    /**
+     * Balance threshold that triggers low-balance warnings and notifications.
+     *
+     * @generated from field: int64 low_balance_threshold_micros = 8;
+     */
+    lowBalanceThresholdMicros: bigint;
+    /**
+     * Saved payment method for off-session charges and Portal display.
+     * Populated automatically after the first Stripe Checkout purchase or
+     * when the user adds a payment method via the Stripe Customer Portal.
+     *
+     * @generated from field: ai.stigmer.billing.v1.PaymentMethodSummary default_payment_method = 11;
+     */
+    defaultPaymentMethod?: PaymentMethodSummary;
+    /**
+     * @generated from field: google.protobuf.Timestamp created_at = 9;
+     */
+    createdAt?: Timestamp;
+    /**
+     * @generated from field: google.protobuf.Timestamp updated_at = 10;
+     */
+    updatedAt?: Timestamp;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.BillingAccount.
+ * Use `create(BillingAccountSchema)` to create a new message.
+ */
+export declare const BillingAccountSchema: GenMessage<BillingAccount>;
+/**
+ * CreditBalance provides the real-time breakdown of an org's credit position.
+ *
+ * Invariant: total_micros = available_micros + reserved_micros
+ * Invariant: total_micros = promotional_micros + purchased_micros
+ *
+ * @generated from message ai.stigmer.billing.v1.CreditBalance
+ */
+export type CreditBalance = Message<"ai.stigmer.billing.v1.CreditBalance"> & {
+    /**
+     * Credits available for new reservations and immediate use.
+     *
+     * @generated from field: int64 available_micros = 1;
+     */
+    availableMicros: bigint;
+    /**
+     * Credits held by active execution reservations.
+     *
+     * @generated from field: int64 reserved_micros = 2;
+     */
+    reservedMicros: bigint;
+    /**
+     * Subset of total from promotional grants (free trial, campaigns).
+     *
+     * @generated from field: int64 promotional_micros = 3;
+     */
+    promotionalMicros: bigint;
+    /**
+     * Subset of total from purchased credits (Stripe payments, auto-recharge).
+     *
+     * @generated from field: int64 purchased_micros = 4;
+     */
+    purchasedMicros: bigint;
+    /**
+     * Total credits (available + reserved).
+     *
+     * @generated from field: int64 total_micros = 5;
+     */
+    totalMicros: bigint;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.CreditBalance.
+ * Use `create(CreditBalanceSchema)` to create a new message.
+ */
+export declare const CreditBalanceSchema: GenMessage<CreditBalance>;
+/**
+ * PaymentMethodSummary holds the display-safe details of a Stripe
+ * PaymentMethod so the UI can render card info without a Stripe API call.
+ *
+ * Populated from Stripe webhook events (checkout.session.completed,
+ * customer.updated) and kept in sync with the Stripe Customer's
+ * default payment method via the Billing Portal.
+ *
+ * @generated from message ai.stigmer.billing.v1.PaymentMethodSummary
+ */
+export type PaymentMethodSummary = Message<"ai.stigmer.billing.v1.PaymentMethodSummary"> & {
+    /**
+     * Stripe PaymentMethod ID (e.g., "pm_1abc...").
+     *
+     * @generated from field: string payment_method_id = 1;
+     */
+    paymentMethodId: string;
+    /**
+     * Card network in lowercase (e.g., "visa", "mastercard", "amex").
+     *
+     * @generated from field: string brand = 2;
+     */
+    brand: string;
+    /**
+     * Last four digits of the card number.
+     *
+     * @generated from field: string last4 = 3;
+     */
+    last4: string;
+    /**
+     * Card expiration month (1–12).
+     *
+     * @generated from field: int32 exp_month = 4;
+     */
+    expMonth: number;
+    /**
+     * Card expiration year (4-digit, e.g., 2027).
+     *
+     * @generated from field: int32 exp_year = 5;
+     */
+    expYear: number;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.PaymentMethodSummary.
+ * Use `create(PaymentMethodSummarySchema)` to create a new message.
+ */
+export declare const PaymentMethodSummarySchema: GenMessage<PaymentMethodSummary>;
+/**
+ * AutoRechargeConfig controls automatic credit top-up behavior.
+ *
+ * When enabled, the billing system triggers a charge against the account's
+ * saved payment method (BillingAccount.default_payment_method) whenever
+ * the available balance drops below threshold_micros.
+ *
+ * Fields 1–4 are user-configurable via SetAutoRechargeConfig.
+ * Fields 5 and 7 are system-managed (updated by the recharge trigger).
+ *
+ * @generated from message ai.stigmer.billing.v1.AutoRechargeConfig
+ */
+export type AutoRechargeConfig = Message<"ai.stigmer.billing.v1.AutoRechargeConfig"> & {
+    /**
+     * Whether auto-recharge is enabled.
+     *
+     * @generated from field: bool enabled = 1;
+     */
+    enabled: boolean;
+    /**
+     * Trigger recharge when available balance drops below this amount.
+     *
+     * @generated from field: int64 threshold_micros = 2;
+     */
+    thresholdMicros: bigint;
+    /**
+     * Fixed amount to charge per recharge event.
+     *
+     * @generated from field: int64 recharge_amount_micros = 3;
+     */
+    rechargeAmountMicros: bigint;
+    /**
+     * Maximum total auto-recharge spend per calendar month.
+     * Prevents runaway charges from aggressive usage patterns.
+     *
+     * @generated from field: int64 monthly_cap_micros = 4;
+     */
+    monthlyCapMicros: bigint;
+    /**
+     * Running total of auto-recharge charges in the current month.
+     * System-managed: incremented on each recharge, lazily reset when
+     * current_month rolls over.
+     *
+     * @generated from field: int64 current_month_charged_micros = 5;
+     */
+    currentMonthChargedMicros: bigint;
+    /**
+     * Calendar month the current_month_charged_micros counter belongs to.
+     * Format: "YYYY-MM" in UTC (e.g., "2026-05"). System-managed: set by
+     * the recharge trigger on the first charge of a new month.
+     *
+     * @generated from field: string current_month = 7;
+     */
+    currentMonth: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.v1.AutoRechargeConfig.
+ * Use `create(AutoRechargeConfigSchema)` to create a new message.
+ */
+export declare const AutoRechargeConfigSchema: GenMessage<AutoRechargeConfig>;

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

@@ -0,0 +1,31 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/billing/v1/billing_account.proto (package ai.stigmer.billing.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_billing_v1_enum } from "./enum_pb.js";
+import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
+/**
+ * Describes the file ai/stigmer/billing/v1/billing_account.proto.
+ */
+export const file_ai_stigmer_billing_v1_billing_account = /*@__PURE__*/ fileDesc("CithaS9zdGlnbWVyL2JpbGxpbmcvdjEvYmlsbGluZ19hY2NvdW50LnByb3RvEhVhaS5zdGlnbWVyLmJpbGxpbmcudjEi+gMKDkJpbGxpbmdBY2NvdW50EgoKAmlkGAEgASgJEg4KBm9yZ19pZBgCIAEoCRI7CgZzdGF0dXMYAyABKA4yKy5haS5zdGlnbWVyLmJpbGxpbmcudjEuQmlsbGluZ0FjY291bnRTdGF0dXMSNQoHYmFsYW5jZRgEIAEoCzIkLmFpLnN0aWdtZXIuYmlsbGluZy52MS5DcmVkaXRCYWxhbmNlEkAKDWF1dG9fcmVjaGFyZ2UYBSABKAsyKS5haS5zdGlnbWVyLmJpbGxpbmcudjEuQXV0b1JlY2hhcmdlQ29uZmlnEhoKEnN0cmlwZV9jdXN0b21lcl9pZBgGIAEoCRInCh9hbGxvd2VkX25lZ2F0aXZlX2JhbGFuY2VfbWljcm9zGAcgASgDEiQKHGxvd19iYWxhbmNlX3RocmVzaG9sZF9taWNyb3MYCCABKAMSSwoWZGVmYXVsdF9wYXltZW50X21ldGhvZBgLIAEoCzIrLmFpLnN0aWdtZXIuYmlsbGluZy52MS5QYXltZW50TWV0aG9kU3VtbWFyeRIuCgpjcmVhdGVkX2F0GAkgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIuCgp1cGRhdGVkX2F0GAogASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcCKOAQoNQ3JlZGl0QmFsYW5jZRIYChBhdmFpbGFibGVfbWljcm9zGAEgASgDEhcKD3Jlc2VydmVkX21pY3JvcxgCIAEoAxIaChJwcm9tb3Rpb25hbF9taWNyb3MYAyABKAMSGAoQcHVyY2hhc2VkX21pY3JvcxgEIAEoAxIUCgx0b3RhbF9taWNyb3MYBSABKAMidAoUUGF5bWVudE1ldGhvZFN1bW1hcnkSGQoRcGF5bWVudF9tZXRob2RfaWQYASABKAkSDQoFYnJhbmQYAiABKAkSDQoFbGFzdDQYAyABKAkSEQoJZXhwX21vbnRoGAQgASgFEhAKCGV4cF95ZWFyGAUgASgFIrgBChJBdXRvUmVjaGFyZ2VDb25maWcSDwoHZW5hYmxlZBgBIAEoCBIYChB0aHJlc2hvbGRfbWljcm9zGAIgASgDEh4KFnJlY2hhcmdlX2Ftb3VudF9taWNyb3MYAyABKAMSGgoSbW9udGhseV9jYXBfbWljcm9zGAQgASgDEiQKHGN1cnJlbnRfbW9udGhfY2hhcmdlZF9taWNyb3MYBSABKAMSFQoNY3VycmVudF9tb250aBgHIAEoCWIGcHJvdG8z", [file_ai_stigmer_billing_v1_enum, file_google_protobuf_timestamp]);
+/**
+ * Describes the message ai.stigmer.billing.v1.BillingAccount.
+ * Use `create(BillingAccountSchema)` to create a new message.
+ */
+export const BillingAccountSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_billing_v1_billing_account, 0);
+/**
+ * Describes the message ai.stigmer.billing.v1.CreditBalance.
+ * Use `create(CreditBalanceSchema)` to create a new message.
+ */
+export const CreditBalanceSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_billing_v1_billing_account, 1);
+/**
+ * Describes the message ai.stigmer.billing.v1.PaymentMethodSummary.
+ * Use `create(PaymentMethodSummarySchema)` to create a new message.
+ */
+export const PaymentMethodSummarySchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_billing_v1_billing_account, 2);
+/**
+ * Describes the message ai.stigmer.billing.v1.AutoRechargeConfig.
+ * Use `create(AutoRechargeConfigSchema)` to create a new message.
+ */
+export const AutoRechargeConfigSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_billing_v1_billing_account, 3);
+//# sourceMappingURL=billing_account_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing_account_pb.js","sourceRoot":"","sources":["../../../../../ai/stigmer/billing/v1/billing_account_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,kHAAkH;AAClH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAGxE;;GAEG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAY,aAAa,CAC9E,QAAQ,CAAC,s2CAAs2C,EAAE,CAAC,+BAA+B,EAAE,8BAA8B,CAAC,CAAC,CAAC;AA6Ft7C;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+B,aAAa,CAC3E,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;AA+C7D;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;AAiD7D;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqC,aAAa,CACvF,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;AA+D7D;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAmC,aAAa,CACnF,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC"}