[pull] main from livekit:main

.changeset/sip-numbers-statuses.md

@@ -0,0 +1,6 @@
+---
+"github.com/livekit/protocol": patch
+"@livekit/protocol": patch
+---
+
+Add separate inbound and outbound statuses for phone numbers.

protobufs/livekit_agent_simulation.proto

@@ -402,12 +402,18 @@ message Scenario {
   // Arbitrary JSON-encoded object, surfaced to the agent under test as
   // SimulationContext userdata (e.g. inputs and benchmark target state).
   string userdata = 5;
+  // SCN_-prefixed guid. Stable across edits to label, instructions, or
+  // expectations, so runs of the same scenario can be correlated over time.
+  string id = 6;
 }
 
 // A named group of scenarios, mirroring a whole scenarios.yaml file.
 message ScenarioGroup {
   string name = 1;
   repeated Scenario scenarios = 2;
+  // SCNG_-prefixed guid. Stable identity of the scenarios file, independent
+  // of its name.
+  string id = 3;
 }
 
 // How the simulated user interacts with the agent under test.

protobufs/livekit_phone_number.proto

@@ -17,7 +17,20 @@ enum PhoneNumberStatus {
   PHONE_NUMBER_STATUS_ACTIVE = 1;       // Number is active and ready for use
   PHONE_NUMBER_STATUS_PENDING = 2;      // Number is being provisioned
   PHONE_NUMBER_STATUS_RELEASED = 3;     // Number has been released
-  PHONE_NUMBER_STATUS_OFFLINE = 4;      // Number is offline (not associated with any dispatch rule)
+  PHONE_NUMBER_STATUS_OFFLINE = 4;      // Number is offline (provider is unreachable)
+}
+
+enum PhoneNumberInboundStatus {
+  PHONE_NUMBER_IN_STATUS_UNSPECIFIED = 0;  // Default value
+  PHONE_NUMBER_IN_STATUS_ACTIVE = 1;       // Number is serving inbound calls
+  PHONE_NUMBER_IN_STATUS_UNAVAILABLE = 2;  // Inbound calling is unavailable
+  PHONE_NUMBER_IN_STATUS_DETACHED = 3;     // Number is not serving calls (not associated with dispatch rules)
+}
+
+enum PhoneNumberOutboundStatus {
+  PHONE_NUMBER_OUT_STATUS_UNSPECIFIED = 0;  // Default value
+  PHONE_NUMBER_OUT_STATUS_ACTIVE = 1;       // Number is can be used to initiate outbound calls
+  PHONE_NUMBER_OUT_STATUS_UNAVAILABLE = 2;  // Outbound calling is unavailable
 }
 
 // Phone number type enumeration
@@ -83,7 +96,7 @@ message PurchasePhoneNumberResponse {
 // ListPhoneNumbersRequest - Request to list phone numbers
 message ListPhoneNumbersRequest {
   optional int32 limit = 1;                 // Maximum number of results (default: 50)
-  repeated PhoneNumberStatus statuses = 2;           // Filter by statuses (active, pending, released)
+  repeated PhoneNumberStatus statuses = 2;  // Filter by statuses (active, pending, released)
   optional TokenPagination page_token = 3;  // Token for pagination (empty for first page)
   optional string sip_dispatch_rule_id = 4 [(logger.name) = "sipDispatchRuleID"]; // Filter by SIP dispatch rule ID
 }
@@ -146,6 +159,8 @@ message PhoneNumber {
   google.protobuf.Timestamp updated_at = 10;  // Last update timestamp
   repeated string capabilities = 11;          // Available capabilities (e.g., "voice", "sms")
   PhoneNumberStatus status = 12;              // Current status
+  PhoneNumberInboundStatus  inbound_status  = 18; // Inbound calling status
+  PhoneNumberOutboundStatus outbound_status = 19; // Outbound calling status
   google.protobuf.Timestamp assigned_at = 13; // Assignment timestamp
   google.protobuf.Timestamp released_at = 14; // Release timestamp (if applicable)
   string sip_dispatch_rule_id = 15 [deprecated=true, (logger.name) = "sipDispatchRuleID"]; // Associated SIP dispatch rule ID (deprecated: use sip_dispatch_rule_ids instead)

utils/guid/id.go

@@ -70,6 +70,8 @@ const (
 	AgentGatewayPrefix                 = "GW_"
 	CarrierPrefix                      = "CR_"
 	PhoneNumberPrefix                  = "PN_"
+	ScenarioPrefix                     = "SCN_"
+	ScenarioGroupPrefix                = "SCNG_"
 )
 
 const (

utils/id.go

@@ -53,6 +53,8 @@ const (
 	CloudAgentPrivateLinkClusterPrefix = guid.CloudAgentPrivateLinkClusterPrefix
 	CloudAgentPrivateLinkGatewayPrefix = guid.CloudAgentPrivateLinkGatewayPrefix
 	CloudAgentPrivateLinkSecretPrefix  = guid.CloudAgentPrivateLinkSecretPrefix
+	ScenarioPrefix                     = guid.ScenarioPrefix
+	ScenarioGroupPrefix                = guid.ScenarioGroupPrefix
 )
 
 func NewGuid(prefix string) string {