@gajae-code/agent-core 0.11.5 → 0.11.7

package/CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## [Unreleased]
 
+## [0.11.7] - 2026-07-22
+
 ## [0.11.3] - 2026-07-19
 
 ### Fixed

package/dist/types/compaction/compaction.d.ts

@@ -235,6 +235,12 @@ export interface HandoffOptions {
     /** Live agent tool list — same purpose. Forced to `toolChoice: "none"`. */
     tools?: AgentTool<any>[];
     customInstructions?: string;
+    /**
+     * Optional user-configured extension appended to the base handoff prompt.
+     * It SUPPLEMENTS the immutable base (safety/continuity structure); it never
+     * replaces `HANDOFF_DOCUMENT_PROMPT`.
+     */
+    promptExtension?: string;
     convertToLlm?: ConvertToLlm;
     initiatorOverride?: MessageAttribution;
     metadata?: Record<string, unknown>;
@@ -254,7 +260,7 @@ export interface HandoffOptions {
     /** Hint that websocket transport should be preferred when supported by the provider implementation. */
     preferWebsockets?: boolean;
 }
-export declare function renderHandoffPrompt(customInstructions?: string): string;
+export declare function renderHandoffPrompt(customInstructions?: string, promptExtension?: string): string;
 export declare function generateHandoff(messages: AgentMessage[], model: Model, apiKey: string, options: HandoffOptions, signal?: AbortSignal): Promise<string>;
 export interface CompactionPreparation {
     /** UUID of first entry to keep */

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/agent-core",
-	"version": "0.11.5",
+	"version": "0.11.7",
 	"description": "General-purpose agent with transport abstraction, state management, and attachment support",
 	"homepage": "https://gajae-code.com",
 	"author": "Yeachan-Heo and Gajae Code Contributors",
@@ -32,9 +32,9 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@gajae-code/ai": "0.11.5",
-		"@gajae-code/natives": "0.11.5",
-		"@gajae-code/utils": "0.11.5",
+		"@gajae-code/ai": "0.11.7",
+		"@gajae-code/natives": "0.11.7",
+		"@gajae-code/utils": "0.11.7",
 		"@opentelemetry/api": "^1.9.0"
 	},
 	"devDependencies": {

package/src/compaction/compaction.ts

@@ -973,6 +973,12 @@ export interface HandoffOptions {
 	/** Live agent tool list — same purpose. Forced to `toolChoice: "none"`. */
 	tools?: AgentTool<any>[];
 	customInstructions?: string;
+	/**
+	 * Optional user-configured extension appended to the base handoff prompt.
+	 * It SUPPLEMENTS the immutable base (safety/continuity structure); it never
+	 * replaces `HANDOFF_DOCUMENT_PROMPT`.
+	 */
+	promptExtension?: string;
 	convertToLlm?: ConvertToLlm;
 	initiatorOverride?: MessageAttribution;
 	metadata?: Record<string, unknown>;
@@ -993,10 +999,11 @@ export interface HandoffOptions {
 	preferWebsockets?: boolean;
 }
 
-export function renderHandoffPrompt(customInstructions?: string): string {
-	if (!customInstructions) return HANDOFF_DOCUMENT_PROMPT;
+export function renderHandoffPrompt(customInstructions?: string, promptExtension?: string): string {
+	if (!customInstructions && !promptExtension) return HANDOFF_DOCUMENT_PROMPT;
 	return prompt.render(handoffDocumentPrompt, {
 		additionalFocus: customInstructions,
+		promptExtension,
 	});
 }
 
@@ -1012,7 +1019,7 @@ export async function generateHandoff(
 		...llmMessages,
 		{
 			role: "user",
-			content: [{ type: "text", text: renderHandoffPrompt(options.customInstructions) }],
+			content: [{ type: "text", text: renderHandoffPrompt(options.customInstructions, options.promptExtension) }],
 			attribution: "agent",
 			timestamp: Date.now(),
 		},

package/src/compaction/prompts/handoff-document.md

@@ -42,6 +42,13 @@ Use exactly this structure:
 1. [What should happen next]
 </output>
 
+{{#if promptExtension}}
+<instruction>
+Additional handoff guidance (supplements — does not replace — the required structure and critical rules above):
+{{promptExtension}}
+</instruction>
+{{/if}}
+
 {{#if additionalFocus}}
 <instruction>
 Additional focus: {{additionalFocus}}