@gajae-code/agent-core 0.11.4 → 0.11.6

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/dist/types/compaction/entries.d.ts

@@ -82,6 +82,11 @@ export interface MCPToolSelectionEntry extends SessionEntryBase {
     /** MCP tool names selected for visibility in discovery mode. */
     selectedToolNames: string[];
 }
+export interface DiscoveredBuiltinToolSelectionEntry extends SessionEntryBase {
+    type: "discovered_builtin_tool_selection";
+    /** Discoverable built-in tool names selected for visibility in discovery mode. */
+    selectedToolNames: string[];
+}
 export interface SessionInitEntry extends SessionEntryBase {
     type: "session_init";
     /** Full system prompt sent to the model */
@@ -112,7 +117,7 @@ export interface ConfiguredModelChainEntry extends SessionEntryBase {
 }
 export interface CustomCompactionSessionEntries {
 }
-export type SessionEntry = SessionMessageEntry | ThinkingLevelChangeEntry | ModelChangeEntry | ServiceTierChangeEntry | CompactionEntry | BranchSummaryEntry | CustomEntry | CustomMessageEntry | LabelEntry | TtsrInjectionEntry | MCPToolSelectionEntry | SessionInitEntry | ModeChangeEntry | ConfiguredModelChainEntry | CustomCompactionSessionEntries[keyof CustomCompactionSessionEntries];
+export type SessionEntry = SessionMessageEntry | ThinkingLevelChangeEntry | ModelChangeEntry | ServiceTierChangeEntry | CompactionEntry | BranchSummaryEntry | CustomEntry | CustomMessageEntry | LabelEntry | TtsrInjectionEntry | MCPToolSelectionEntry | DiscoveredBuiltinToolSelectionEntry | SessionInitEntry | ModeChangeEntry | ConfiguredModelChainEntry | CustomCompactionSessionEntries[keyof CustomCompactionSessionEntries];
 export interface ReadonlySessionManager {
     getBranch(leafId?: string | null): SessionEntry[];
     getEntry(id: string): SessionEntry | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/agent-core",
-	"version": "0.11.4",
+	"version": "0.11.6",
 	"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.4",
-		"@gajae-code/natives": "0.11.4",
-		"@gajae-code/utils": "0.11.4",
+		"@gajae-code/ai": "0.11.6",
+		"@gajae-code/natives": "0.11.6",
+		"@gajae-code/utils": "0.11.6",
 		"@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/entries.ts

@@ -95,6 +95,12 @@ export interface MCPToolSelectionEntry extends SessionEntryBase {
 	selectedToolNames: string[];
 }
 
+export interface DiscoveredBuiltinToolSelectionEntry extends SessionEntryBase {
+	type: "discovered_builtin_tool_selection";
+	/** Discoverable built-in tool names selected for visibility in discovery mode. */
+	selectedToolNames: string[];
+}
+
 export interface SessionInitEntry extends SessionEntryBase {
 	type: "session_init";
 	/** Full system prompt sent to the model */
@@ -140,6 +146,7 @@ export type SessionEntry =
 	| LabelEntry
 	| TtsrInjectionEntry
 	| MCPToolSelectionEntry
+	| DiscoveredBuiltinToolSelectionEntry
 	| SessionInitEntry
 	| ModeChangeEntry
 	| ConfiguredModelChainEntry

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}}