docs: finish cross-SDK audit corrections

Correct the advisory threshold example and align Azure routing and reasoning-effort API documentation across all six SDKs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: SteveSandersonMS

docs/hooks/user-prompt-submitted.md

@@ -431,16 +431,16 @@ const session = await client.createSession({
       while (promptTimestamps.length > 0 && promptTimestamps[0] < now - RATE_WINDOW) {
         promptTimestamps.shift();
       }
-      
+
+      promptTimestamps.push(now);
       if (promptTimestamps.length >= NOTICE_THRESHOLD) {
         // This is advisory context for the model, not an enforced rate limit.
         // Enforce hard limits before calling session.send().
         return {
-          additionalContext: `The user has sent ${NOTICE_THRESHOLD} prompts in the last minute. Suggest waiting before sending more.`,
+          additionalContext: `The user has sent ${promptTimestamps.length} prompts in the last minute. Suggest waiting before sending more.`,
         };
       }
-      
-      promptTimestamps.push(now);
+
       return null;
     },
   },
@@ -491,7 +491,7 @@ const session = await client.createSession({
 
 1. **Use `additionalContext` over `modifiedPrompt`** - Adding context is less intrusive than rewriting the prompt.
 
-1. **Use `additionalContext` for advisory guidance** - This hook cannot reject a prompt or enforce policy. Enforce hard limits before calling `session.send()`.
+1. **Use `additionalContext` for advisory guidance**: This hook cannot reject a prompt or enforce policy. Enforce hard limits before calling `session.send()`.
 
 1. **Keep processing fast** - This hook runs on every user message. Avoid slow operations.
 

dotnet/src/Types.cs

@@ -2275,7 +2275,7 @@ public sealed class CapiSessionOptions
 public sealed class AzureOptions
 {
     /// <summary>
-    /// Azure OpenAI API version to use (e.g., "2024-02-01").
+    /// Azure OpenAI API version. When omitted, the runtime uses the GA versionless v1 route.
     /// </summary>
     [JsonPropertyName("apiVersion")]
     public string? ApiVersion { get; set; }
@@ -2660,8 +2660,8 @@ public sealed class CustomAgentConfig
 
     /// <summary>
     /// Reasoning effort level for this agent's model.
-    /// When omitted, no per-agent override is sent and the backend chooses its
-    /// default. The parent session effort is not inherited.
+    /// When omitted, the runtime resolves model configuration, then inherits
+    /// the parent effort only if this agent uses the same model.
     /// </summary>
     [JsonPropertyName("reasoningEffort")]
     public string? ReasoningEffort { get; set; }

go/types.go

@@ -950,8 +950,8 @@ type CustomAgentConfig struct {
 	// falling back to the parent session model if unavailable.
 	Model string `json:"model,omitempty"`
 	// ReasoningEffort is the reasoning effort level for this agent's model.
-	// When empty, no per-agent override is sent and the backend chooses its
-	// default. The parent session effort is not inherited.
+	// When empty, the runtime resolves model configuration, then inherits the
+	// parent effort only for the same model.
 	ReasoningEffort string `json:"reasoningEffort,omitempty"`
 }
 

java/src/main/java/com/github/copilot/rpc/AzureOptions.java

@@ -12,6 +12,7 @@
  * <p>
  * When using a BYOK (Bring Your Own Key) setup with Azure OpenAI, this class
  * allows you to specify Azure-specific settings such as the API version to use.
+ * When no API version is set, the runtime uses the GA versionless v1 route.
  *
  * <h2>Example Usage</h2>
  *
@@ -32,7 +33,8 @@ public class AzureOptions {
     /**
      * Gets the Azure OpenAI API version.
      *
-     * @return the API version string
+     * @return the API version string, or {@code null} to use the GA versionless v1
+     *         route
      */
     public String getApiVersion() {
         return apiVersion;
@@ -42,6 +44,7 @@ public String getApiVersion() {
      * Sets the Azure OpenAI API version to use.
      * <p>
      * Examples: {@code "2024-02-01"}, {@code "2023-12-01-preview"}
+     * When this option is not set, the runtime uses the GA versionless v1 route.
      *
      * @param apiVersion
      *            the API version string

java/src/main/java/com/github/copilot/rpc/CustomAgentConfig.java

@@ -298,8 +298,8 @@ public String getReasoningEffort() {
     /**
      * Sets the reasoning effort level for this agent's model.
      * <p>
-     * When omitted, no per-agent override is sent and the backend chooses its
-     * default. The parent session effort is not inherited.
+     * When omitted, the runtime resolves model configuration, then inherits the
+     * parent effort only if this agent uses the same model.
      *
      * @param reasoningEffort
      *            the reasoning effort level

nodejs/src/types.ts

@@ -1643,8 +1643,8 @@ export interface CustomAgentConfig {
     model?: string;
     /**
      * Reasoning effort level for this agent's model.
-     * When omitted, no per-agent override is sent and the backend chooses its
-     * default. The parent session effort is not inherited.
+     * When omitted, the runtime resolves the effort from model configuration,
+     * then inherits the parent effort only if this agent uses the same model.
      */
     reasoningEffort?: ReasoningEffort;
 }

python/copilot/session.py

@@ -1080,8 +1080,8 @@ class CustomAgentConfig(TypedDict, total=False):
     skills: NotRequired[list[str]]
     # Model identifier (e.g. "claude-haiku-4.5"); runtime falls back to parent model if unavailable
     model: NotRequired[str]
-    # Reasoning effort for this agent's model. When omitted, no per-agent override
-    # is sent and the backend chooses its default; the parent effort is not inherited.
+    # Reasoning effort for this agent's model. When omitted, the runtime resolves
+    # model configuration, then inherits the parent effort only for the same model.
     reasoning_effort: NotRequired[ReasoningEffort]
 
 

rust/src/types.rs

@@ -644,8 +644,8 @@ pub struct CustomAgentConfig {
     pub model: Option<String>,
     /// Reasoning effort level for this agent's model.
     ///
-    /// When unset, no per-agent override is sent and the backend chooses its
-    /// default. The parent session effort is not inherited.
+    /// When unset, the runtime resolves model configuration, then inherits the
+    /// parent effort only for the same model.
     #[serde(default, skip_serializing_if = "Option::is_none")]
     pub reasoning_effort: Option<String>,
 }