@gajae-code/agent-core 0.12.7 → 0.12.8

package/CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## [Unreleased]
 
+## [0.12.8] - 2026-08-02
+
 ## [0.12.7] - 2026-07-31
 
 ## [0.12.6] - 2026-07-31

package/dist/types/agent.d.ts

@@ -206,6 +206,11 @@ export declare class Agent {
     };
     /** Return the Agent-owned attempt scope authority for session record injection. */
     getAttemptScopeAuthority(): import("./attempt-scope").AttemptScopeAuthority;
+    /**
+     * Observe each main-attempt scope synchronously, before any provider or
+     * extension-capable lifecycle work can begin.
+     */
+    setMainAttemptScopeObserver(observer: ((scope: AttemptScope) => void) | undefined): void;
     streamFn: StreamFn;
     getApiKey?: (provider: string) => Promise<string | undefined> | string | undefined;
     getAuthCredentialType?: (provider: string) => "api_key" | "oauth" | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/agent-core",
-	"version": "0.12.7",
+	"version": "0.12.8",
 	"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.12.7",
-		"@gajae-code/natives": "0.12.7",
-		"@gajae-code/utils": "0.12.7",
+		"@gajae-code/ai": "0.12.8",
+		"@gajae-code/natives": "0.12.8",
+		"@gajae-code/utils": "0.12.8",
 		"@opentelemetry/api": "^1.9.0"
 	},
 	"devDependencies": {

package/src/agent.ts

@@ -344,7 +344,11 @@ export class Agent {
 	#listeners = new Set<(e: AgentEvent) => void>();
 	#abortController?: AbortController;
 	#convertToLlm: (messages: AgentMessage[]) => Message[] | Promise<Message[]>;
-	#transformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;
+	#transformContext?: (
+		messages: AgentMessage[],
+		signal?: AbortSignal,
+		scope?: AttemptScope,
+	) => Promise<AgentMessage[]>;
 	#steeringQueue: AgentMessage[] = [];
 	#followUpQueue: AgentMessage[] = [];
 	#followUpForceOneAtATime = new WeakSet<AgentMessage>();
@@ -395,6 +399,7 @@ export class Agent {
 	#maintainContext?: AgentLoopConfig["maintainContext"];
 	#telemetry?: AgentLoopConfig["telemetry"];
 	#appendOnlyContext?: AppendOnlyContextManager;
+	#mainAttemptScopeObserver?: (scope: AttemptScope) => void;
 
 	get intentTracing(): boolean {
 		return this.#intentTracing;
@@ -419,6 +424,17 @@ export class Agent {
 	getAttemptScopeAuthority() {
 		return this.#attemptAuthority;
 	}
+	/**
+	 * Observe each main-attempt scope synchronously, before any provider or
+	 * extension-capable lifecycle work can begin.
+	 */
+	setMainAttemptScopeObserver(observer: ((scope: AttemptScope) => void) | undefined): void {
+		this.#mainAttemptScopeObserver = observer;
+	}
+
+	#observeMainAttemptScope(scope: AttemptScope): void {
+		this.#mainAttemptScopeObserver?.(scope);
+	}
 
 	streamFn: StreamFn;
 	getApiKey?: (provider: string) => Promise<string | undefined> | string | undefined;
@@ -1439,6 +1455,7 @@ export class Agent {
 		}
 		const logicalRunId = managedLogicalRunOwner ?? runId;
 		const scope = this.#attemptAuthority.mintMain();
+		this.#observeMainAttemptScope(scope);
 		const handle: AttemptRunHandle = { logicalRunId, scope };
 		this.#runHandles.set(logicalRunId, handle);
 		options?.onRunAccepted?.(handle);
@@ -1547,7 +1564,13 @@ export class Agent {
 			preferWebsockets: this.#preferWebsockets,
 			convertToLlm: this.#convertToLlm,
 			transformContext: this.#transformContext,
-			attemptMinter: { mint: () => this.#attemptAuthority.mintMain() },
+			attemptMinter: {
+				mint: () => {
+					const scope = this.#attemptAuthority.mintMain();
+					this.#observeMainAttemptScope(scope);
+					return scope;
+				},
+			},
 			initialScope: scope,
 			onPayload: this.#onPayload,
 			onResponse: this.#onResponse,