@f5-sales-demo/xcsh 19.61.2 → 19.61.3

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/xcsh",
-	"version": "19.61.2",
+	"version": "19.61.3",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5-sales-demo/xcsh",
 	"author": "Can Boluk",
@@ -56,13 +56,13 @@
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.16.1",
 		"@mozilla/readability": "^0.6",
-		"@f5-sales-demo/xcsh-stats": "19.61.2",
-		"@f5-sales-demo/pi-agent-core": "19.61.2",
-		"@f5-sales-demo/pi-ai": "19.61.2",
-		"@f5-sales-demo/pi-natives": "19.61.2",
-		"@f5-sales-demo/pi-resource-management": "19.61.2",
-		"@f5-sales-demo/pi-tui": "19.61.2",
-		"@f5-sales-demo/pi-utils": "19.61.2",
+		"@f5-sales-demo/xcsh-stats": "19.61.3",
+		"@f5-sales-demo/pi-agent-core": "19.61.3",
+		"@f5-sales-demo/pi-ai": "19.61.3",
+		"@f5-sales-demo/pi-natives": "19.61.3",
+		"@f5-sales-demo/pi-resource-management": "19.61.3",
+		"@f5-sales-demo/pi-tui": "19.61.3",
+		"@f5-sales-demo/pi-utils": "19.61.3",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.20",

package/src/commands/worker.ts

@@ -233,6 +233,23 @@ export default class Worker extends Command {
 			...(process.env.XCSH_BENCH_EXTENSION ? { additionalExtensionPaths: [process.env.XCSH_BENCH_EXTENSION] } : {}),
 		});
 
+		// TTFT Phase 3 hermeticity: the bench-instant stand-in provider is registered while
+		// createAgentSession loads the bench extension (additionalExtensionPaths), which is
+		// AFTER the default-model role is resolved — so the worker would otherwise fall back
+		// to a real provider and the benchmark would measure live network TTFT, not xcsh
+		// overhead. In bench mode, explicitly select bench-instant now that it is registered.
+		// Gated on XCSH_BENCH_EXTENSION → completely inert for a normal `xcsh worker`.
+		if (process.env.XCSH_BENCH_EXTENSION) {
+			const benchModel = session.modelRegistry.find("bench-instant", "bench-instant");
+			if (benchModel) {
+				await session.setModel(benchModel);
+			} else {
+				console.error(
+					"[xcsh worker] BENCH ERROR: bench-instant model not registered — benchmark would measure a real provider",
+				);
+			}
+		}
+
 		const chatHandler = new ChatHandler(bridge, session);
 		chatHandler.attach();
 

package/src/internal-urls/build-info.generated.ts

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "19.61.2",
-	"commit": "b6923d7302a3f43d8b9600ed4bddd6e26f16fad6",
-	"shortCommit": "b6923d7",
+	"version": "19.61.3",
+	"commit": "1546a875f07608812967e1169ea86c2bd3f837ac",
+	"shortCommit": "1546a87",
 	"branch": "main",
-	"tag": "v19.61.2",
-	"commitDate": "2026-07-07T05:10:31Z",
-	"buildDate": "2026-07-07T05:33:53.753Z",
+	"tag": "v19.61.3",
+	"commitDate": "2026-07-07T11:57:08Z",
+	"buildDate": "2026-07-07T12:21:42.145Z",
 	"dirty": true,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5-sales-demo/xcsh",
 	"repoSlug": "f5-sales-demo/xcsh",
-	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/b6923d7302a3f43d8b9600ed4bddd6e26f16fad6",
-	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v19.61.2"
+	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/1546a875f07608812967e1169ea86c2bd3f837ac",
+	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v19.61.3"
 };

package/src/internal-urls/terraform-index.generated.ts

@@ -269,9 +269,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 			category: "load-balancing",
 			description:
 				"Advertise_policy object controls how and where a service represented by a given virtual_host object is advertised to consumers. configuration",
-			required: ["name", "namespace", "address", "protocol", "skip_xff_append"],
+			required: ["name", "address", "protocol", "skip_xff_append"],
 			minimal_config:
-				'resource "xcsh_advertise_policy" "example" {\n  name      = "example-advertise-policy"\n  namespace = "staging"\n\n  address         = "example-value"\n  protocol        = "example-value"\n  skip_xff_append = true\n}',
+				'resource "xcsh_advertise_policy" "example" {\n  name      = "example-advertise-policy"\n  namespace = "system"\n\n  address         = "example-value"\n  protocol        = "example-value"\n  skip_xff_append = true\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -293,7 +293,7 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 			description: "New Alert Receiver object",
 			required: ["name", "namespace", "receiver_choice"],
 			minimal_config:
-				'resource "xcsh_alert_receiver" "example" {\n  name      = "example-alert-receiver"\n  namespace = "staging"\n}',
+				'resource "xcsh_alert_receiver" "example" {\n  name      = "example-alert-receiver"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -302,9 +302,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		api_crawler: {
 			category: "api-security",
 			description: "API Crawler resource",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_api_crawler" "example" {\n  name      = "example-api-crawler"\n  namespace = "staging"\n}',
+				'resource "xcsh_api_crawler" "example" {\n  name      = "example-api-crawler"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -315,7 +315,7 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 			description: "API Definition",
 			required: ["name", "namespace"],
 			minimal_config:
-				'resource "xcsh_api_definition" "example" {\n  name      = "example-api-definition"\n  namespace = "staging"\n}',
+				'resource "xcsh_api_definition" "example" {\n  name      = "example-api-definition"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: ["namespace"],
 			},
@@ -326,7 +326,7 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 			description: "API discovery creates a new object in the storage backend for metadata.namespace",
 			required: ["name", "namespace", "user_defined_api_discovery_policy"],
 			minimal_config:
-				'resource "xcsh_api_discovery" "example" {\n  name      = "example-api-discovery"\n  namespace = "staging"\n}',
+				'resource "xcsh_api_discovery" "example" {\n  name      = "example-api-discovery"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -335,9 +335,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		api_testing: {
 			category: "api-security",
 			description: "API Testing resource",
-			required: ["name", "namespace", "custom_header_value"],
+			required: ["name", "custom_header_value"],
 			minimal_config:
-				'resource "xcsh_api_testing" "example" {\n  name      = "example-api-testing"\n  namespace = "staging"\n\n  custom_header_value = "example-value"\n}',
+				'resource "xcsh_api_testing" "example" {\n  name      = "example-api-testing"\n  namespace = "system"\n\n  custom_header_value = "example-value"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -356,9 +356,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		app_api_group: {
 			category: "api-security",
 			description: "App_api_group creates a new object in the storage backend for metadata.namespace",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_app_api_group" "example" {\n  name      = "example-app-api-group"\n  namespace = "staging"\n}',
+				'resource "xcsh_app_api_group" "example" {\n  name      = "example-app-api-group"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -378,9 +378,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		app_setting: {
 			category: "applications",
 			description: "App setting configuration in namespace metadata.namespace",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_app_setting" "example" {\n  name      = "example-app-setting"\n  namespace = "staging"\n}',
+				'resource "xcsh_app_setting" "example" {\n  name      = "example-app-setting"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -389,9 +389,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		app_type: {
 			category: "applications",
 			description: "App type will create the configuration in namespace metadata.namespace",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_app_type" "example" {\n  name      = "example-app-type"\n  namespace = "staging"\n}',
+				'resource "xcsh_app_type" "example" {\n  name      = "example-app-type"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -433,9 +433,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		aws_tgw_site: {
 			category: "sites",
 			description: "Deploying F5 sites connected via AWS Transit Gateway",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_aws_tgw_site" "example" {\n  name      = "example-aws-tgw-site"\n  namespace = "staging"\n}',
+				'resource "xcsh_aws_tgw_site" "example" {\n  name      = "example-aws-tgw-site"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -444,9 +444,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		aws_vpc_site: {
 			category: "sites",
 			description: "Deploying F5 sites within AWS VPC environments",
-			required: ["name", "namespace", "address", "aws_region", "disk_size", "instance_type", "ssh_key"],
+			required: ["name", "address", "aws_region", "disk_size", "instance_type", "ssh_key"],
 			minimal_config:
-				'resource "xcsh_aws_vpc_site" "example" {\n  name      = "example-aws-vpc-site"\n  namespace = "staging"\n\n  aws_region    = "example-value"\n  instance_type = "example-value"\n  ssh_key       = "example-value"\n  address       = "example-value"\n  disk_size     = 1\n}',
+				'resource "xcsh_aws_vpc_site" "example" {\n  name      = "example-aws-vpc-site"\n  namespace = "system"\n\n  aws_region    = "example-value"\n  instance_type = "example-value"\n  ssh_key       = "example-value"\n  address       = "example-value"\n  disk_size     = 1\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -455,9 +455,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		azure_vnet_site: {
 			category: "sites",
 			description: "Deploying F5 sites within Azure Virtual Network environments",
-			required: ["name", "namespace", "machine_type", "resource_group", "ssh_key"],
+			required: ["name", "machine_type", "resource_group", "ssh_key"],
 			minimal_config:
-				'resource "xcsh_azure_vnet_site" "example" {\n  name      = "example-Azure-vnet-site"\n  namespace = "staging"\n\n  machine_type   = "example-value"\n  resource_group = "example-value"\n  ssh_key        = "example-value"\n}',
+				'resource "xcsh_azure_vnet_site" "example" {\n  name      = "example-Azure-vnet-site"\n  namespace = "system"\n\n  machine_type   = "example-value"\n  resource_group = "example-value"\n  ssh_key        = "example-value"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -467,8 +467,8 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 			category: "networking",
 			description:
 				"Bgp object is the configuration for peering with external bgp servers. it is created by users in system namespace. configuration",
-			required: ["name", "namespace"],
-			minimal_config: 'resource "xcsh_bgp" "example" {\n  name      = "example-bgp"\n  namespace = "staging"\n}',
+			required: ["name"],
+			minimal_config: 'resource "xcsh_bgp" "example" {\n  name      = "example-bgp"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -477,9 +477,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		bgp_asn_set: {
 			category: "networking",
 			description: "Bgp_asn_set creates a new object in the storage backend for metadata.namespace",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_bgp_asn_set" "example" {\n  name      = "example-bgp-asn-set"\n  namespace = "staging"\n\n  as_numbers = [1]\n}',
+				'resource "xcsh_bgp_asn_set" "example" {\n  name      = "example-bgp-asn-set"\n  namespace = "system"\n\n  as_numbers = [1]\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -588,9 +588,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		cloud_credentials: {
 			category: "authentication",
 			description: "Api to create cloud_credentials object. configuration",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_cloud_credentials" "example" {\n  name      = "example-cloud-credentials"\n  namespace = "staging"\n}',
+				'resource "xcsh_cloud_credentials" "example" {\n  name      = "example-cloud-credentials"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -599,9 +599,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		cloud_elastic_ip: {
 			category: "cloud-resources",
 			description: "Cloud Elastic IP creates Cloud Elastic IP object Object is attached to a site",
-			required: ["name", "namespace", "item_count"],
+			required: ["name", "item_count"],
 			minimal_config:
-				'resource "xcsh_cloud_elastic_ip" "example" {\n  name      = "example-cloud-elastic-ip"\n  namespace = "staging"\n\n  item_count = 1\n}',
+				'resource "xcsh_cloud_elastic_ip" "example" {\n  name      = "example-cloud-elastic-ip"\n  namespace = "system"\n\n  item_count = 1\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -651,9 +651,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		code_base_integration: {
 			category: "integrations",
 			description: "Integration details",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_code_base_integration" "example" {\n  name      = "example-code-base-integration"\n  namespace = "staging"\n}',
+				'resource "xcsh_code_base_integration" "example" {\n  name      = "example-code-base-integration"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -706,9 +706,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		dc_cluster_group: {
 			category: "networking",
 			description: "DC Cluster group in given namespace",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_dc_cluster_group" "example" {\n  name      = "example-dc-cluster-group"\n  namespace = "staging"\n}',
+				'resource "xcsh_dc_cluster_group" "example" {\n  name      = "example-dc-cluster-group"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -717,9 +717,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		discovery: {
 			category: "applications",
 			description: "Api to create discovery object for a site or virtual site in system namespace. configuration",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_discovery" "example" {\n  name      = "example-discovery"\n  namespace = "staging"\n}',
+				'resource "xcsh_discovery" "example" {\n  name      = "example-discovery"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -740,9 +740,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		dns_domain: {
 			category: "dns",
 			description: "DNS Domain in a given namespace. If one already exist it will give a error",
-			required: ["name", "namespace", "dnssec_mode"],
+			required: ["name", "dnssec_mode"],
 			minimal_config:
-				'resource "xcsh_dns_domain" "example" {\n  name      = "example-dns-domain"\n  namespace = "staging"\n\n  dnssec_mode = "DNSSEC_DISABLE"\n}',
+				'resource "xcsh_dns_domain" "example" {\n  name      = "example-dns-domain"\n  namespace = "system"\n\n  dnssec_mode = "DNSSEC_DISABLE"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -751,9 +751,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		dns_lb_health_check: {
 			category: "dns",
 			description: "DNS Load Balancer Health Check in a given namespace. If one already exist it will give a error",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_dns_lb_health_check" "example" {\n  name      = "example-dns-lb-health-check"\n  namespace = "staging"\n}',
+				'resource "xcsh_dns_lb_health_check" "example" {\n  name      = "example-dns-lb-health-check"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -762,9 +762,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		dns_lb_pool: {
 			category: "dns",
 			description: "DNS Load Balancer Pool in a given namespace. If one already exist it will give a error",
-			required: ["name", "namespace", "load_balancing_mode"],
+			required: ["name", "load_balancing_mode"],
 			minimal_config:
-				'resource "xcsh_dns_lb_pool" "example" {\n  name      = "example-dns-lb-pool"\n  namespace = "staging"\n\n  load_balancing_mode = "ROUND_ROBIN"\n}',
+				'resource "xcsh_dns_lb_pool" "example" {\n  name      = "example-dns-lb-pool"\n  namespace = "system"\n\n  load_balancing_mode = "ROUND_ROBIN"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -795,9 +795,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		dns_zone: {
 			category: "dns",
 			description: "DNS Zone in a given namespace. If one already exist it will give a error",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_dns_zone" "example" {\n  name      = "example-dns-zone"\n  namespace = "staging"\n}',
+				'resource "xcsh_dns_zone" "example" {\n  name      = "example-dns-zone"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -806,9 +806,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		endpoint: {
 			category: "load-balancing",
 			description: "Endpoint will create the object in the storage backend for namespace metadata.namespace",
-			required: ["name", "namespace", "health_check_port", "port", "protocol"],
+			required: ["name", "health_check_port", "port", "protocol"],
 			minimal_config:
-				'resource "xcsh_endpoint" "example" {\n  name      = "example-endpoint"\n  namespace = "staging"\n\n  health_check_port = 1\n  port              = 1\n  protocol          = "example-value"\n}',
+				'resource "xcsh_endpoint" "example" {\n  name      = "example-endpoint"\n  namespace = "system"\n\n  health_check_port = 1\n  port              = 1\n  protocol          = "example-value"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -851,9 +851,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		fast_acl_rule: {
 			category: "security",
 			description: "New Fast ACL rule, has specification to match source IP, source port and action to apply",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_fast_acl_rule" "example" {\n  name      = "example-fast-acl-rule"\n  namespace = "staging"\n}',
+				'resource "xcsh_fast_acl_rule" "example" {\n  name      = "example-fast-acl-rule"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -875,14 +875,13 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 			description: "Fleet will create a fleet object in 'system' namespace of the user",
 			required: [
 				"name",
-				"namespace",
 				"enable_default_fleet_config_download",
 				"fleet_label",
 				"operating_system_version",
 				"volterra_software_version",
 			],
 			minimal_config:
-				'resource "xcsh_fleet" "example" {\n  name      = "example-fleet"\n  namespace = "staging"\n\n  fleet_label                          = "example-value"\n  enable_default_fleet_config_download = true\n  operating_system_version             = "example-value"\n  volterra_software_version            = "example-value"\n}',
+				'resource "xcsh_fleet" "example" {\n  name      = "example-fleet"\n  namespace = "system"\n\n  fleet_label                          = "example-value"\n  enable_default_fleet_config_download = true\n  operating_system_version             = "example-value"\n  volterra_software_version            = "example-value"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -913,9 +912,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		gcp_vpc_site: {
 			category: "sites",
 			description: "Deploying F5 sites within Google Cloud VPC environments",
-			required: ["name", "namespace", "address", "disk_size", "gcp_region", "instance_type", "ssh_key"],
+			required: ["name", "address", "disk_size", "gcp_region", "instance_type", "ssh_key"],
 			minimal_config:
-				'resource "xcsh_gcp_vpc_site" "example" {\n  name      = "example-gcp-vpc-site"\n  namespace = "staging"\n\n  gcp_region    = "example-value"\n  instance_type = "example-value"\n  ssh_key       = "example-value"\n  address       = "example-value"\n  disk_size     = 1\n}',
+				'resource "xcsh_gcp_vpc_site" "example" {\n  name      = "example-gcp-vpc-site"\n  namespace = "system"\n\n  gcp_region    = "example-value"\n  instance_type = "example-value"\n  ssh_key       = "example-value"\n  address       = "example-value"\n  disk_size     = 1\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -937,7 +936,7 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 			description: "New Global Log Receiver object",
 			required: ["name", "namespace", "log_type", "receiver_choice"],
 			minimal_config:
-				'resource "xcsh_global_log_receiver" "example" {\n  name      = "example-global-log-receiver"\n  namespace = "staging"\n}',
+				'resource "xcsh_global_log_receiver" "example" {\n  name      = "example-global-log-receiver"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1039,7 +1038,7 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 			description: "K8s_cluster will create the object in the storage backend for namespace metadata.namespace",
 			required: ["name", "namespace"],
 			minimal_config:
-				'resource "xcsh_k8s_cluster" "example" {\n  name      = "example-k8s-cluster"\n  namespace = "staging"\n}',
+				'resource "xcsh_k8s_cluster" "example" {\n  name      = "example-k8s-cluster"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1048,9 +1047,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		k8s_cluster_role: {
 			category: "kubernetes",
 			description: "K8s_cluster_role will create the object in the storage backend for namespace metadata.namespace",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_k8s_cluster_role" "example" {\n  name      = "example-k8s-cluster-role"\n  namespace = "staging"\n}',
+				'resource "xcsh_k8s_cluster_role" "example" {\n  name      = "example-k8s-cluster-role"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1060,9 +1059,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 			category: "kubernetes",
 			description:
 				"K8s_cluster_role_binding will create the object in the storage backend for namespace metadata.namespace",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_k8s_cluster_role_binding" "example" {\n  name      = "example-k8s-cluster-role-binding"\n  namespace = "staging"\n}',
+				'resource "xcsh_k8s_cluster_role_binding" "example" {\n  name      = "example-k8s-cluster-role-binding"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1094,9 +1093,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		log_receiver: {
 			category: "monitoring",
 			description: "New Log Receiver object",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_log_receiver" "example" {\n  name      = "example-log-receiver"\n  namespace = "staging"\n}',
+				'resource "xcsh_log_receiver" "example" {\n  name      = "example-log-receiver"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1140,9 +1139,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		nat_policy: {
 			category: "security",
 			description: "Nat policy create specification configures nat policy with multiple rules,. configuration",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_nat_policy" "example" {\n  name      = "example-nat-policy"\n  namespace = "staging"\n}',
+				'resource "xcsh_nat_policy" "example" {\n  name      = "example-nat-policy"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1151,9 +1150,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		network_connector: {
 			category: "networking",
 			description: "Network connector is created by users in system namespace. configuration",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_network_connector" "example" {\n  name      = "example-network-connector"\n  namespace = "staging"\n}',
+				'resource "xcsh_network_connector" "example" {\n  name      = "example-network-connector"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1164,7 +1163,7 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 			description: "Network firewall is created by users in system namespace. configuration",
 			required: ["name", "namespace"],
 			minimal_config:
-				'resource "xcsh_network_firewall" "example" {\n  name      = "example-network-firewall"\n  namespace = "staging"\n}',
+				'resource "xcsh_network_firewall" "example" {\n  name      = "example-network-firewall"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1174,9 +1173,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 			category: "networking",
 			description:
 				"Network interface represents configuration of a network device. it is created by users in system namespace. configuration",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_network_interface" "example" {\n  name      = "example-network-interface"\n  namespace = "staging"\n}',
+				'resource "xcsh_network_interface" "example" {\n  name      = "example-network-interface"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1196,9 +1195,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		network_policy_rule: {
 			category: "security",
 			description: "Network policy rule with configured parameters in specified namespace",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_network_policy_rule" "example" {\n  name      = "example-network-policy-rule"\n  namespace = "staging"\n}',
+				'resource "xcsh_network_policy_rule" "example" {\n  name      = "example-network-policy-rule"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1218,9 +1217,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		nfv_service: {
 			category: "networking",
 			description: "New NFV service with configured parameters",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_nfv_service" "example" {\n  name      = "example-nfv-service"\n  namespace = "staging"\n}',
+				'resource "xcsh_nfv_service" "example" {\n  name      = "example-nfv-service"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1230,9 +1229,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 			category: "networking",
 			description:
 				"Api to create nginx service discovery object for a site or virtual site in system namespace. configuration",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_nginx_service_discovery" "example" {\n  name      = "example-nginx-service-discovery"\n  namespace = "staging"\n}',
+				'resource "xcsh_nginx_service_discovery" "example" {\n  name      = "example-nginx-service-discovery"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1279,7 +1278,7 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 				"Protocol Inspection Specification in a given namespace. If one already exists it will give an error",
 			required: ["name", "namespace", "enable_disable_compliance_checks", "enable_disable_signatures"],
 			minimal_config:
-				'resource "xcsh_protocol_inspection" "example" {\n  name      = "example-protocol-inspection"\n  namespace = "staging"\n}',
+				'resource "xcsh_protocol_inspection" "example" {\n  name      = "example-protocol-inspection"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1344,9 +1343,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		secret_management_access: {
 			category: "authentication",
 			description: "Secret_management_access creates a new object in storage backend for metadata.namespace",
-			required: ["name", "namespace", "provider_name"],
+			required: ["name", "provider_name"],
 			minimal_config:
-				'resource "xcsh_secret_management_access" "example" {\n  name      = "example-secret-management-access"\n  namespace = "staging"\n\n  provider_name = "example-value"\n}',
+				'resource "xcsh_secret_management_access" "example" {\n  name      = "example-secret-management-access"\n  namespace = "system"\n\n  provider_name = "example-value"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1355,9 +1354,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		securemesh_site: {
 			category: "sites",
 			description: "Deploying secure mesh edge sites with distributed security capabilities",
-			required: ["name", "namespace", "address", "volterra_certified_hw"],
+			required: ["name", "address", "volterra_certified_hw"],
 			minimal_config:
-				'resource "xcsh_securemesh_site" "example" {\n  name      = "example-securemesh-site"\n  namespace = "staging"\n\n  volterra_certified_hw = "example-value"\n  worker_nodes          = ["example-value"]\n  address               = "example-value"\n}',
+				'resource "xcsh_securemesh_site" "example" {\n  name      = "example-securemesh-site"\n  namespace = "system"\n\n  volterra_certified_hw = "example-value"\n  worker_nodes          = ["example-value"]\n  address               = "example-value"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1366,9 +1365,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		securemesh_site_v2: {
 			category: "sites",
 			description: "Deploying secure mesh edge sites with enhanced security and networking features",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_securemesh_site_v2" "example" {\n  name      = "example-securemesh-site-v2"\n  namespace = "staging"\n}',
+				'resource "xcsh_securemesh_site_v2" "example" {\n  name      = "example-securemesh-site-v2"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1421,9 +1420,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		site: {
 			category: "sites",
 			description: "Virtual site object in given namespace",
-			required: ["name", "namespace", "site_type"],
+			required: ["name", "site_type"],
 			minimal_config:
-				'resource "xcsh_site" "example" {\n  name      = "example-site"\n  namespace = "staging"\n\n  site_type = "INVALID"\n}',
+				'resource "xcsh_site" "example" {\n  name      = "example-site"\n  namespace = "system"\n\n  site_type = "INVALID"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1432,9 +1431,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		site_mesh_group: {
 			category: "sites",
 			description: "Site Mesh Group in system namespace of user",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_site_mesh_group" "example" {\n  name      = "example-site-mesh-group"\n  namespace = "staging"\n}',
+				'resource "xcsh_site_mesh_group" "example" {\n  name      = "example-site-mesh-group"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1483,9 +1482,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		tenant_configuration: {
 			category: "organization",
 			description: "Tenant configuration specification. configuration",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_tenant_configuration" "example" {\n  name      = "example-tenant-configuration"\n  namespace = "staging"\n}',
+				'resource "xcsh_tenant_configuration" "example" {\n  name      = "example-tenant-configuration"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1527,9 +1526,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		usb_policy: {
 			category: "security",
 			description: "New USB policy object",
-			required: ["name", "namespace"],
+			required: ["name"],
 			minimal_config:
-				'resource "xcsh_usb_policy" "example" {\n  name      = "example-usb-policy"\n  namespace = "staging"\n}',
+				'resource "xcsh_usb_policy" "example" {\n  name      = "example-usb-policy"\n  namespace = "system"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1581,9 +1580,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		virtual_network: {
 			category: "networking",
 			description: "Virtual network in given namespace",
-			required: ["name", "namespace", "legacy_type"],
+			required: ["name", "legacy_type"],
 			minimal_config:
-				'resource "xcsh_virtual_network" "example" {\n  name      = "example-virtual-network"\n  namespace = "staging"\n\n  legacy_type = "VIRTUAL_NETWORK_SITE_LOCAL"\n}',
+				'resource "xcsh_virtual_network" "example" {\n  name      = "example-virtual-network"\n  namespace = "system"\n\n  legacy_type = "VIRTUAL_NETWORK_SITE_LOCAL"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1594,7 +1593,7 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 			description: "Virtual site object in given namespace",
 			required: ["name", "namespace", "site_type", "site_selector"],
 			minimal_config:
-				'resource "xcsh_virtual_site" "example" {\n  name      = "example-virtual-site"\n  namespace = "staging"\n\n  site_type = "INVALID"\n}',
+				'resource "xcsh_virtual_site" "example" {\n  name      = "example-virtual-site"\n  namespace = "system"\n\n  site_type = "INVALID"\n}',
 			dependencies: {
 				requires: [],
 			},
@@ -1603,9 +1602,9 @@ export const TERRAFORM_INDEX: TerraformIndex = {
 		voltstack_site: {
 			category: "sites",
 			description: "Deploying Volterra stack sites for edge computing",
-			required: ["name", "namespace", "address", "volterra_certified_hw"],
+			required: ["name", "address", "volterra_certified_hw"],
 			minimal_config:
-				'resource "xcsh_voltstack_site" "example" {\n  name      = "example-voltstack-site"\n  namespace = "staging"\n\n  volterra_certified_hw = "example-value"\n  worker_nodes          = ["example-value"]\n  address               = "example-value"\n}',
+				'resource "xcsh_voltstack_site" "example" {\n  name      = "example-voltstack-site"\n  namespace = "system"\n\n  volterra_certified_hw = "example-value"\n  worker_nodes          = ["example-value"]\n  address               = "example-value"\n}',
 			dependencies: {
 				requires: [],
 			},

package/src/session/agent-session.ts

@@ -2658,8 +2658,12 @@ export class AgentSession {
 				);
 			}
 
-			// Validate API key
-			const apiKey = await this.#modelRegistry.getApiKey(this.model, this.sessionId);
+			// Validate API key. Capture the guard-narrowed model into a local: TS narrowing
+			// of the `this.model` getter does not persist into the ttftAttr closure below.
+			const model = this.model;
+			const apiKey = await logger.ttftAttr("ttft.getapikey", () =>
+				this.#modelRegistry.getApiKey(model, this.sessionId),
+			);
 			if (!apiKey) {
 				throw new Error(
 					`No API key found for ${this.model.provider}.\n\n` +
@@ -2674,20 +2678,23 @@ export class AgentSession {
 			}
 
 			// Build messages array (session context, eager todo prelude, then active prompt message)
-			const messages: AgentMessage[] = [];
-			const planReferenceMessage = await this.#buildPlanReferenceMessage?.();
-			if (planReferenceMessage) {
-				messages.push(planReferenceMessage);
-			}
-			const planModeMessage = await this.#buildPlanModeMessage();
-			if (planModeMessage) {
-				messages.push(planModeMessage);
-			}
-			if (options?.prependMessages) {
-				messages.push(...options.prependMessages);
-			}
+			const messages: AgentMessage[] = await logger.ttftAttr("ttft.build-context", async () => {
+				const built: AgentMessage[] = [];
+				const planReferenceMessage = await this.#buildPlanReferenceMessage?.();
+				if (planReferenceMessage) {
+					built.push(planReferenceMessage);
+				}
+				const planModeMessage = await this.#buildPlanModeMessage();
+				if (planModeMessage) {
+					built.push(planModeMessage);
+				}
+				if (options?.prependMessages) {
+					built.push(...options.prependMessages);
+				}
 
-			messages.push(message);
+				built.push(message);
+				return built;
+			});
 
 			// Early bail-out: if a newer abort/prompt cycle started during setup,
 			// return before mutating shared state (nextTurn messages, system prompt).
@@ -2711,12 +2718,12 @@ export class AgentSession {
 				messages.push(...fileMentionMessages);
 			}
 
-			// Emit before_agent_start extension event
+			// Emit before_agent_start extension event. Capture the narrowed runner into a
+			// local: the `this.#extensionRunner` guard does not narrow inside the closure.
 			if (this.#extensionRunner) {
-				const result = await this.#extensionRunner.emitBeforeAgentStart(
-					expandedText,
-					options?.images,
-					this.#baseSystemPrompt,
+				const runner = this.#extensionRunner;
+				const result = await logger.ttftAttr("ttft.before-agent-start-hook", () =>
+					runner.emitBeforeAgentStart(expandedText, options?.images, this.#baseSystemPrompt),
 				);
 				if (result?.messages) {
 					const promptAttribution: "user" | "agent" | undefined =
@@ -2747,7 +2754,9 @@ export class AgentSession {
 			}
 
 			const agentPromptOptions = options?.toolChoice ? { toolChoice: options.toolChoice } : undefined;
-			await this.#promptAgentWithIdleRetry(messages, agentPromptOptions);
+			await logger.ttftAttr("ttft.agent-loop-total", () =>
+				this.#promptAgentWithIdleRetry(messages, agentPromptOptions),
+			);
 			if (!options?.skipPostPromptRecoveryWait) {
 				await this.#waitForPostPromptRecovery();
 			}