Add last_instructions configurable section

MackinnonBuck · Copilot · MackinnonBuck · commit 28b1bc5049ea · 2026-03-17T09:12:10.000-07:00
Expose lastInstructions as a customizable section across all 4 SDKs,
addressing review feedback about duplicate tool-efficiency blocks.

Co-authored-by: Copilot &lt;223556219+Copilot@users.noreply.github.com&gt;
diff --git a/docs/getting-started.md b/docs/getting-started.md
@@ -1277,7 +1277,7 @@ const session = await client.createSession({
 });
 ```
 
-Available section IDs: `identity`, `tone`, `tool_efficiency`, `environment_context`, `code_change_rules`, `guidelines`, `safety`, `tool_instructions`, `custom_instructions`.
+Available section IDs: `identity`, `tone`, `tool_efficiency`, `environment_context`, `code_change_rules`, `guidelines`, `safety`, `tool_instructions`, `custom_instructions`, `last_instructions`.
 
 Each override supports four actions: `replace`, `remove`, `append`, and `prepend`. Unknown section IDs are handled gracefully — content is appended to additional instructions and a warning is emitted; `remove` on unknown sections is silently ignored.
 
diff --git a/dotnet/README.md b/dotnet/README.md
@@ -510,7 +510,7 @@ var session = await client.CreateSessionAsync(new SessionConfig
 });
 ```
 
-Available section IDs are defined as constants on `SystemPromptSections`: `Identity`, `Tone`, `ToolEfficiency`, `EnvironmentContext`, `CodeChangeRules`, `Guidelines`, `Safety`, `ToolInstructions`, `CustomInstructions`.
+Available section IDs are defined as constants on `SystemPromptSections`: `Identity`, `Tone`, `ToolEfficiency`, `EnvironmentContext`, `CodeChangeRules`, `Guidelines`, `Safety`, `ToolInstructions`, `CustomInstructions`, `LastInstructions`.
 
 Each section override supports four actions: `Replace`, `Remove`, `Append`, and `Prepend`. Unknown section IDs are handled gracefully: content is appended to additional instructions, and `Remove` overrides are silently ignored.
 
diff --git a/dotnet/src/Types.cs b/dotnet/src/Types.cs
@@ -1033,6 +1033,8 @@ public static class SystemPromptSections
     public const string ToolInstructions = "tool_instructions";
     /// <summary>Repository and organization custom instructions.</summary>
     public const string CustomInstructions = "custom_instructions";
+    /// <summary>End-of-prompt instructions: parallel tool calling, persistence, task completion.</summary>
+    public const string LastInstructions = "last_instructions";
 }
 
 /// <summary>
diff --git a/go/README.md b/go/README.md
@@ -152,7 +152,7 @@ Event types: `SessionLifecycleCreated`, `SessionLifecycleDeleted`, `SessionLifec
 - `SystemMessage` (\*SystemMessageConfig): System message configuration. Supports three modes:
   - **append** (default): Appends `Content` after the SDK-managed prompt
   - **replace**: Replaces the entire prompt with `Content`
-  - **customize**: Selectively override individual sections via `Sections` map (keys: `SectionIdentity`, `SectionTone`, `SectionToolEfficiency`, `SectionEnvironmentContext`, `SectionCodeChangeRules`, `SectionGuidelines`, `SectionSafety`, `SectionToolInstructions`, `SectionCustomInstructions`; values: `SectionOverride` with `Action` and optional `Content`)
+  - **customize**: Selectively override individual sections via `Sections` map (keys: `SectionIdentity`, `SectionTone`, `SectionToolEfficiency`, `SectionEnvironmentContext`, `SectionCodeChangeRules`, `SectionGuidelines`, `SectionSafety`, `SectionToolInstructions`, `SectionCustomInstructions`, `SectionLastInstructions`; values: `SectionOverride` with `Action` and optional `Content`)
 - `Provider` (\*ProviderConfig): Custom API provider configuration (BYOK). See [Custom Providers](#custom-providers) section.
 - `Streaming` (bool): Enable streaming delta events
 - `InfiniteSessions` (\*InfiniteSessionConfig): Automatic context compaction configuration
@@ -215,7 +215,7 @@ session, err := client.CreateSession(ctx, &copilot.SessionConfig{
 })
 ```
 
-Available section constants: `SectionIdentity`, `SectionTone`, `SectionToolEfficiency`, `SectionEnvironmentContext`, `SectionCodeChangeRules`, `SectionGuidelines`, `SectionSafety`, `SectionToolInstructions`, `SectionCustomInstructions`.
+Available section constants: `SectionIdentity`, `SectionTone`, `SectionToolEfficiency`, `SectionEnvironmentContext`, `SectionCodeChangeRules`, `SectionGuidelines`, `SectionSafety`, `SectionToolInstructions`, `SectionCustomInstructions`, `SectionLastInstructions`.
 
 Each section override supports four actions:
 - **`replace`** — Replace the section content entirely
diff --git a/go/types.go b/go/types.go
@@ -122,6 +122,7 @@ const (
 	SectionSafety             = "safety"
 	SectionToolInstructions   = "tool_instructions"
 	SectionCustomInstructions = "custom_instructions"
+	SectionLastInstructions   = "last_instructions"
 )
 
 // SectionOverride defines an override operation for a single system prompt section.
diff --git a/nodejs/README.md b/nodejs/README.md
@@ -486,7 +486,7 @@ const session = await client.createSession({
 });
 ```
 
-Available section IDs: `identity`, `tone`, `tool_efficiency`, `environment_context`, `code_change_rules`, `guidelines`, `safety`, `tool_instructions`, `custom_instructions`. Use the `SYSTEM_PROMPT_SECTIONS` constant for descriptions of each section.
+Available section IDs: `identity`, `tone`, `tool_efficiency`, `environment_context`, `code_change_rules`, `guidelines`, `safety`, `tool_instructions`, `custom_instructions`, `last_instructions`. Use the `SYSTEM_PROMPT_SECTIONS` constant for descriptions of each section.
 
 Each section override supports four actions:
 - **`replace`** — Replace the section content entirely
diff --git a/nodejs/src/types.ts b/nodejs/src/types.ts
@@ -285,7 +285,8 @@ export type SystemPromptSection =
     | "guidelines"
     | "safety"
     | "tool_instructions"
-    | "custom_instructions";
+    | "custom_instructions"
+    | "last_instructions";
 
 /** Section metadata for documentation and tooling. */
 export const SYSTEM_PROMPT_SECTIONS: Record<SystemPromptSection, { description: string }> = {
@@ -298,6 +299,7 @@ export const SYSTEM_PROMPT_SECTIONS: Record<SystemPromptSection, { description:
     safety: { description: "Environment limitations, prohibited actions, security policies" },
     tool_instructions: { description: "Per-tool usage instructions" },
     custom_instructions: { description: "Repository and organization custom instructions" },
+    last_instructions: { description: "End-of-prompt instructions: parallel tool calling, persistence, task completion" },
 };
 
 /**
diff --git a/python/README.md b/python/README.md
@@ -143,7 +143,7 @@ CopilotClient(
 - `system_message` (dict): System message configuration. Supports three modes:
   - **append** (default): Appends `content` after the SDK-managed prompt
   - **replace**: Replaces the entire prompt with `content`
-  - **customize**: Selectively override individual sections via `sections` dict (keys: `"identity"`, `"tone"`, `"tool_efficiency"`, `"environment_context"`, `"code_change_rules"`, `"guidelines"`, `"safety"`, `"tool_instructions"`, `"custom_instructions"`; values: `SectionOverride` with `action` and optional `content`)
+  - **customize**: Selectively override individual sections via `sections` dict (keys: `"identity"`, `"tone"`, `"tool_efficiency"`, `"environment_context"`, `"code_change_rules"`, `"guidelines"`, `"safety"`, `"tool_instructions"`, `"custom_instructions"`, `"last_instructions"`; values: `SectionOverride` with `action` and optional `content`)
 - `streaming` (bool): Enable streaming delta events
 - `provider` (dict): Custom API provider configuration (BYOK). See [Custom Providers](#custom-providers) section.
 - `infinite_sessions` (dict): Automatic context compaction configuration
@@ -217,7 +217,7 @@ session = await client.create_session(
 )
 ```
 
-Available section IDs: `"identity"`, `"tone"`, `"tool_efficiency"`, `"environment_context"`, `"code_change_rules"`, `"guidelines"`, `"safety"`, `"tool_instructions"`, `"custom_instructions"`. Use the `SYSTEM_PROMPT_SECTIONS` dict for descriptions of each section.
+Available section IDs: `"identity"`, `"tone"`, `"tool_efficiency"`, `"environment_context"`, `"code_change_rules"`, `"guidelines"`, `"safety"`, `"tool_instructions"`, `"custom_instructions"`, `"last_instructions"`. Use the `SYSTEM_PROMPT_SECTIONS` dict for descriptions of each section.
 
 Each section override supports four actions:
 - **`replace`** — Replace the section content entirely
diff --git a/python/copilot/types.py b/python/copilot/types.py
@@ -217,6 +217,7 @@ class Tool:
     "safety",
     "tool_instructions",
     "custom_instructions",
+    "last_instructions",
 ]
 
 SYSTEM_PROMPT_SECTIONS: dict[SystemPromptSection, str] = {
@@ -229,6 +230,7 @@ class Tool:
     "safety": "Environment limitations, prohibited actions, security policies",
     "tool_instructions": "Per-tool usage instructions",
     "custom_instructions": "Repository and organization custom instructions",
+    "last_instructions": "End-of-prompt instructions: parallel tool calling, persistence, task completion",
 }
 
 

Original file line number	Diff line number	Diff line change
`@@ -1033,6 +1033,8 @@ public static class SystemPromptSections`
`1033`	`1033`	`public const string ToolInstructions = "tool_instructions";`
`1034`	`1034`	`/// <summary>Repository and organization custom instructions.</summary>`
`1035`	`1035`	`public const string CustomInstructions = "custom_instructions";`
	`1036`	`+ /// <summary>End-of-prompt instructions: parallel tool calling, persistence, task completion.</summary>`
	`1037`	`+ public const string LastInstructions = "last_instructions";`
`1036`	`1038`	`}`
`1037`	`1039`
`1038`	`1040`	`/// <summary>`
Original file line number	Diff line number	Diff line change
`@@ -122,6 +122,7 @@ const (`
`122`	`122`	`SectionSafety = "safety"`
`123`	`123`	`SectionToolInstructions = "tool_instructions"`
`124`	`124`	`SectionCustomInstructions = "custom_instructions"`
	`125`	`+ SectionLastInstructions = "last_instructions"`
`125`	`126`	`)`
`126`	`127`
`127`	`128`	`// SectionOverride defines an override operation for a single system prompt section.`
Original file line number	Diff line number	Diff line change
`@@ -217,6 +217,7 @@ class Tool:`
`217`	`217`	`"safety",`
`218`	`218`	`"tool_instructions",`
`219`	`219`	`"custom_instructions",`
	`220`	`+ "last_instructions",`
`220`	`221`	`]`
`221`	`222`
`222`	`223`	`SYSTEM_PROMPT_SECTIONS: dict[SystemPromptSection, str] = {`
`@@ -229,6 +230,7 @@ class Tool:`
`229`	`230`	`"safety": "Environment limitations, prohibited actions, security policies",`
`230`	`231`	`"tool_instructions": "Per-tool usage instructions",`
`231`	`232`	`"custom_instructions": "Repository and organization custom instructions",`
	`233`	`+ "last_instructions": "End-of-prompt instructions: parallel tool calling, persistence, task completion",`
`232`	`234`	`}`
`233`	`235`
`234`	`236`