@cuylabs/agent-core 4.10.0 → 5.0.0

package/dist/{chunk-VMGZKIFT.js → chunk-EDKZOPUV.js}

@@ -1,11 +1,11 @@
 import {
   createAgentContextFragmentMessage
-} from "./chunk-AAGKWUXR.js";
+} from "./chunk-CGP6UNCQ.js";
 
-// src/storage/types.ts
-var STORAGE_VERSION = 1;
+// src/sessions/types.ts
+var SESSION_FORMAT_VERSION = 1;
 
-// src/storage/utils.ts
+// src/sessions/utils.ts
 function generateEntryId(existingIds) {
   for (let i = 0; i < 100; i++) {
     const id = crypto.randomUUID().slice(0, 8);
@@ -298,8 +298,8 @@ function normalizeRecentMessagesLimit(limit) {
   return Math.floor(limit);
 }
 
-// src/storage/memory.ts
-var MemoryStorage = class {
+// src/sessions/store/memory.ts
+var InMemorySessionStore = class {
   sessions = /* @__PURE__ */ new Map();
   async create(header) {
     if (this.sessions.has(header.id)) {
@@ -350,224 +350,7 @@ var MemoryStorage = class {
   }
 };
 
-// src/storage/file/helpers.ts
-import {
-  appendFile,
-  mkdir,
-  readFile,
-  readdir,
-  stat,
-  unlink,
-  writeFile
-} from "fs/promises";
-import { existsSync } from "fs";
-import { basename, join } from "path";
-async function ensureStorageDirectory(directory) {
-  if (!existsSync(directory)) {
-    await mkdir(directory, { recursive: true });
-  }
-}
-function getSessionFilePath(directory, extension, sessionId) {
-  const safeId = sessionId.replace(/[^a-zA-Z0-9-_]/g, "_");
-  const needsHash = safeId !== sessionId;
-  if (needsHash) {
-    let hash = 2166136261;
-    for (let i = 0; i < sessionId.length; i++) {
-      hash ^= sessionId.charCodeAt(i);
-      hash = hash * 16777619 >>> 0;
-    }
-    const suffix = hash.toString(16).padStart(8, "0");
-    return join(directory, `${safeId}_${suffix}${extension}`);
-  }
-  return join(directory, `${safeId}${extension}`);
-}
-async function loadEntriesFromDisk(filePath, sessionId) {
-  try {
-    const content = await readFile(filePath, "utf-8");
-    return parseJSONL(content);
-  } catch (error) {
-    if (error.code === "ENOENT") {
-      throw new Error(`Session not found: ${sessionId}`);
-    }
-    throw error;
-  }
-}
-async function createSessionFile(filePath, header) {
-  await writeFile(filePath, toJSONL(header), "utf-8");
-}
-async function appendSessionEntry(filePath, entry) {
-  await appendFile(filePath, toJSONL(entry), "utf-8");
-}
-async function appendSessionEntries(filePath, entries) {
-  await appendFile(filePath, toJSONLBatch(entries), "utf-8");
-}
-function sessionFileExists(filePath) {
-  return existsSync(filePath);
-}
-async function deleteSessionFile(filePath) {
-  if (!existsSync(filePath)) {
-    return false;
-  }
-  try {
-    await unlink(filePath);
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function listSessionIds(directory, extension) {
-  try {
-    const files = await readdir(directory);
-    return files.filter((file) => file.endsWith(extension)).map((file) => basename(file, extension));
-  } catch {
-    return [];
-  }
-}
-async function clearSessionFiles(directory, extension) {
-  try {
-    const files = await readdir(directory);
-    await Promise.all(
-      files.filter((file) => file.endsWith(extension)).map((file) => unlink(join(directory, file)).catch(() => {
-      }))
-    );
-  } catch {
-  }
-}
-async function getSessionFileStats(filePath) {
-  try {
-    const info = await stat(filePath);
-    return {
-      size: info.size,
-      mtime: info.mtime
-    };
-  } catch {
-    return null;
-  }
-}
-
-// src/storage/file/storage.ts
-var FileStorage = class {
-  directory;
-  extension;
-  useCache;
-  cache = /* @__PURE__ */ new Map();
-  initialized = false;
-  constructor(options) {
-    this.directory = options.directory;
-    this.extension = options.extension ?? ".jsonl";
-    this.useCache = options.cache ?? true;
-  }
-  async ensureDir() {
-    if (this.initialized) return;
-    await ensureStorageDirectory(this.directory);
-    this.initialized = true;
-  }
-  getPath(sessionId) {
-    return getSessionFilePath(this.directory, this.extension, sessionId);
-  }
-  async getEntries(sessionId) {
-    if (this.useCache && this.cache.has(sessionId)) {
-      return this.cache.get(sessionId);
-    }
-    const entries = await loadEntriesFromDisk(
-      this.getPath(sessionId),
-      sessionId
-    );
-    if (this.useCache) {
-      this.cache.set(sessionId, entries);
-    }
-    return entries;
-  }
-  async create(header) {
-    await this.ensureDir();
-    const filePath = this.getPath(header.id);
-    if (sessionFileExists(filePath)) {
-      throw new Error(`Session already exists: ${header.id}`);
-    }
-    await createSessionFile(filePath, header);
-    if (this.useCache) {
-      this.cache.set(header.id, [header]);
-    }
-  }
-  async append(sessionId, entry) {
-    await this.ensureDir();
-    const filePath = this.getPath(sessionId);
-    if (!sessionFileExists(filePath)) {
-      throw new Error(`Session not found: ${sessionId}`);
-    }
-    await appendSessionEntry(filePath, entry);
-    if (this.useCache) {
-      this.cache.get(sessionId)?.push(entry);
-    }
-  }
-  async appendBatch(sessionId, entries) {
-    if (entries.length === 0) return;
-    await this.ensureDir();
-    const filePath = this.getPath(sessionId);
-    if (!sessionFileExists(filePath)) {
-      throw new Error(`Session not found: ${sessionId}`);
-    }
-    await appendSessionEntries(filePath, entries);
-    if (this.useCache) {
-      this.cache.get(sessionId)?.push(...entries);
-    }
-  }
-  async read(sessionId) {
-    await this.ensureDir();
-    return [...await this.getEntries(sessionId)];
-  }
-  async delete(sessionId) {
-    this.cache.delete(sessionId);
-    return deleteSessionFile(this.getPath(sessionId));
-  }
-  async exists(sessionId) {
-    if (this.useCache && this.cache.has(sessionId)) {
-      return true;
-    }
-    return sessionFileExists(this.getPath(sessionId));
-  }
-  async list() {
-    await this.ensureDir();
-    const infos = [];
-    for (const sessionId of await listSessionIds(
-      this.directory,
-      this.extension
-    )) {
-      try {
-        const info = extractSessionInfo(
-          await this.getEntries(sessionId),
-          this.getPath(sessionId)
-        );
-        if (info) {
-          infos.push(info);
-        }
-      } catch {
-      }
-    }
-    infos.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
-    return infos;
-  }
-  async clear() {
-    this.cache.clear();
-    await clearSessionFiles(this.directory, this.extension);
-  }
-  flushCache() {
-    this.cache.clear();
-  }
-  async reload(sessionId) {
-    this.cache.delete(sessionId);
-    return this.read(sessionId);
-  }
-  async listIds() {
-    await this.ensureDir();
-    return listSessionIds(this.directory, this.extension);
-  }
-  async getStats(sessionId) {
-    return getSessionFileStats(this.getPath(sessionId));
-  }
-};
-
-// src/storage/lock.ts
+// src/sessions/store/lock.ts
 var LocalSessionTurnLock = class {
   locks = /* @__PURE__ */ new Map();
   async acquire(sessionId, options = {}) {
@@ -642,74 +425,29 @@ function createAbortError() {
   return error;
 }
 
-// src/storage/paths.ts
-import { homedir } from "os";
-import { join as join2 } from "path";
-import { execSync } from "child_process";
-function getDataDir(appName = "cuylabs") {
-  const platform = process.platform;
-  if (platform === "darwin") {
-    return join2(homedir(), `.${appName}`);
-  }
-  if (platform === "win32") {
-    return join2(
-      process.env.APPDATA || join2(homedir(), "AppData", "Roaming"),
-      appName
-    );
-  }
-  const xdgData = process.env.XDG_DATA_HOME || join2(homedir(), ".local", "share");
-  return join2(xdgData, appName);
-}
-function getSessionsDir(appName = "cuylabs") {
-  return join2(getDataDir(appName), "sessions");
-}
-function getGitRootHash(cwd) {
-  try {
-    const result = execSync("git rev-list --max-parents=0 --all 2>/dev/null", {
-      cwd,
-      encoding: "utf-8"
-    });
-    const roots = result.split("\n").filter(Boolean).map((s) => s.trim()).sort();
-    return roots[0] || null;
-  } catch {
-    return null;
-  }
-}
-function getProjectId(cwd) {
-  const gitHash = getGitRootHash(cwd);
-  if (gitHash) {
-    return gitHash.slice(0, 12);
-  }
-  return cwd.replace(/^\//, "").replace(/[/\\:]/g, "-").replace(/\s+/g, "-").toLowerCase().slice(-50);
-}
-function getProjectSessionsDir(cwd, appName = "cuylabs") {
-  const projectId = getProjectId(cwd);
-  return join2(getSessionsDir(appName), projectId);
-}
-
-// src/storage/manager/session-manager.ts
+// src/sessions/manager/session-manager.ts
 var SessionManager = class {
-  storage;
+  store;
   currentSessionId = null;
   currentLeafId = null;
   entriesCache = [];
   idsCache = /* @__PURE__ */ new Set();
   entriesByIdCache = /* @__PURE__ */ new Map();
-  constructor(storage) {
-    this.storage = storage ?? new MemoryStorage();
+  constructor(store) {
+    this.store = store ?? new InMemorySessionStore();
   }
   async create(options) {
     const id = options.id ?? crypto.randomUUID();
     const header = {
       type: "header",
-      version: STORAGE_VERSION,
+      version: SESSION_FORMAT_VERSION,
       id,
       cwd: options.cwd,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       title: options.title,
       parentSessionId: options.parentSessionId
     };
-    await this.storage.create(header);
+    await this.store.create(header);
     this.currentSessionId = id;
     this.currentLeafId = null;
     this.entriesCache = [header];
@@ -718,7 +456,7 @@ var SessionManager = class {
     return id;
   }
   async load(sessionId) {
-    const entries = await this.storage.read(sessionId);
+    const entries = await this.store.read(sessionId);
     if (entries.length === 0) {
       throw new Error(`Empty session: ${sessionId}`);
     }
@@ -750,7 +488,7 @@ var SessionManager = class {
       this.currentLeafId,
       this.idsCache
     );
-    await this.storage.append(this.currentSessionId, entry);
+    await this.store.append(this.currentSessionId, entry);
     this.entriesCache.push(entry);
     this.idsCache.add(entry.id);
     this.entriesByIdCache.set(entry.id, entry);
@@ -773,7 +511,7 @@ var SessionManager = class {
       this.entriesByIdCache.set(entry.id, entry);
       parentId = entry.id;
     }
-    await this.storage.appendBatch(this.currentSessionId, entries);
+    await this.store.appendBatch(this.currentSessionId, entries);
     this.entriesCache.push(...entries);
     this.currentLeafId = entries[entries.length - 1].id;
     return entries.map((entry) => entry.id);
@@ -811,7 +549,7 @@ var SessionManager = class {
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       ...options
     };
-    await this.storage.append(this.currentSessionId, entry);
+    await this.store.append(this.currentSessionId, entry);
     this.entriesCache.push(entry);
     this.idsCache.add(entry.id);
     this.entriesByIdCache.set(entry.id, entry);
@@ -837,15 +575,19 @@ var SessionManager = class {
       id: compactionId,
       parentId: this.currentLeafId,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      ...options.phase ? { phase: options.phase } : {},
+      ...options.trigger ? { trigger: options.trigger } : {},
+      ...options.reason ? { reason: options.reason } : {},
       summary: options.summary,
       ...options.displaySummary === false ? { displaySummary: false } : {},
       firstKeptEntryId: messageEntries[0]?.id ?? compactionId,
       tokensBefore: options.tokensBefore,
       tokensAfter: options.tokensAfter,
+      ...options.cutReason ? { cutReason: options.cutReason } : {},
       ...options.readFiles ? { readFiles: options.readFiles } : {},
       ...options.modifiedFiles ? { modifiedFiles: options.modifiedFiles } : {}
     };
-    await this.storage.appendBatch(this.currentSessionId, [
+    await this.store.appendBatch(this.currentSessionId, [
       compactionEntry,
       ...messageEntries
     ]);
@@ -872,7 +614,7 @@ var SessionManager = class {
       branchFromId: fromEntryId,
       summary
     };
-    await this.storage.append(this.currentSessionId, entry);
+    await this.store.append(this.currentSessionId, entry);
     this.entriesCache.push(entry);
     this.idsCache.add(entry.id);
     this.entriesByIdCache.set(entry.id, entry);
@@ -894,7 +636,7 @@ var SessionManager = class {
       this.currentLeafId,
       this.idsCache
     );
-    await this.storage.append(this.currentSessionId, entry);
+    await this.store.append(this.currentSessionId, entry);
     this.entriesCache.push(entry);
     this.idsCache.add(entry.id);
     this.entriesByIdCache.set(entry.id, entry);
@@ -933,10 +675,10 @@ var SessionManager = class {
     return header?.type === "header" ? header : null;
   }
   async listSessions() {
-    return this.storage.list();
+    return this.store.list();
   }
   async deleteSession(sessionId) {
-    const result = await this.storage.delete(sessionId);
+    const result = await this.store.delete(sessionId);
     if (sessionId === this.currentSessionId) {
       this.currentSessionId = null;
       this.currentLeafId = null;
@@ -947,14 +689,14 @@ var SessionManager = class {
     return result;
   }
   async sessionExists(sessionId) {
-    return this.storage.exists(sessionId);
+    return this.store.exists(sessionId);
   }
-  getStorage() {
-    return this.storage;
+  getStore() {
+    return this.store;
   }
 };
 
-// src/storage/manager/default.ts
+// src/sessions/manager/default.ts
 var defaultManager = null;
 function getDefaultSessionManager() {
   if (!defaultManager) {
@@ -962,13 +704,13 @@ function getDefaultSessionManager() {
   }
   return defaultManager;
 }
-function configureDefaultSessionManager(storage) {
-  defaultManager = new SessionManager(storage);
+function configureDefaultSessionManager(store) {
+  defaultManager = new SessionManager(store);
   return defaultManager;
 }
 
 export {
-  STORAGE_VERSION,
+  SESSION_FORMAT_VERSION,
   generateEntryId,
   parseJSONL,
   toJSONL,
@@ -983,14 +725,8 @@ export {
   buildMessagesFromEntries,
   buildRecentMessagesFromEntries,
   buildRecentMessagesFromEntryMap,
-  MemoryStorage,
-  FileStorage,
+  InMemorySessionStore,
   LocalSessionTurnLock,
-  getDataDir,
-  getSessionsDir,
-  getGitRootHash,
-  getProjectId,
-  getProjectSessionsDir,
   SessionManager,
   getDefaultSessionManager,
   configureDefaultSessionManager

package/dist/{chunk-TU5KDFWI.js → chunk-GHVW7L4P.js}

@@ -221,6 +221,47 @@ var MiddlewareRunner = class {
     return contextFragments;
   }
   // --------------------------------------------------------------------------
+  // context compaction commit lifecycle — before in array order, after in reverse order
+  // --------------------------------------------------------------------------
+  /**
+   * Run all `beforeContextCompactionCommit` hooks in order.
+   *
+   * Hooks are awaited because durability work, such as memory capture, must
+   * complete before old context is replaced. Errors are logged and do not abort
+   * compaction.
+   */
+  async runBeforeContextCompactionCommit(ctx) {
+    for (const mw of this.stack) {
+      if (!mw.beforeContextCompactionCommit) continue;
+      try {
+        await mw.beforeContextCompactionCommit(ctx);
+      } catch (err) {
+        this.log.warn(
+          `"${mw.name}" beforeContextCompactionCommit error: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+  }
+  /**
+   * Run all `afterContextCompactionCommit` hooks in reverse order.
+   *
+   * This mirrors `afterToolCall` / `model.output` ordering. Errors are logged
+   * and do not abort the turn.
+   */
+  async runAfterContextCompactionCommit(ctx) {
+    for (let i = this.stack.length - 1; i >= 0; i--) {
+      const mw = this.stack[i];
+      if (!mw.afterContextCompactionCommit) continue;
+      try {
+        await mw.afterContextCompactionCommit(ctx);
+      } catch (err) {
+        this.log.warn(
+          `"${mw.name}" afterContextCompactionCommit error: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+  }
+  // --------------------------------------------------------------------------
   // onEvent — fire-and-forget, all run
   // --------------------------------------------------------------------------
   /**

package/dist/{chunk-IQA64CAO.js → chunk-TYQWH6XH.js}

@@ -1,6 +1,6 @@
 import {
   applyAgentContextFragmentsWithReport
-} from "./chunk-AAGKWUXR.js";
+} from "./chunk-CGP6UNCQ.js";
 
 // src/context/assembly/prepare.ts
 var DEFAULT_CONTEXT_FRAGMENT_BUDGET_RATIO = 0.1;
@@ -54,10 +54,14 @@ async function assembleModelContext(options) {
     configured: options.contextFragmentBudget,
     windowBefore
   });
+  const tokenEstimator = options.window?.getTokenEstimator?.();
   const contextFragmentResult = applyAgentContextFragmentsWithReport(
     baseMessages,
     requestedContextFragments,
-    contextFragmentBudget ? { budget: contextFragmentBudget } : {}
+    {
+      ...contextFragmentBudget ? { budget: contextFragmentBudget } : {},
+      ...tokenEstimator ? { tokenEstimator } : {}
+    }
   );
   const messages = contextFragmentResult.messages;
   const windowAfter = options.window?.getStats(messages);

package/dist/context/assembly/prepare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../src/context/assembly/prepare.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,2BAA2B,EAE3B,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AA+DpB;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAkCrC"}
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../src/context/assembly/prepare.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,2BAA2B,EAE3B,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AA+DpB;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAsCrC"}

package/dist/context/assembly/types.d.ts

@@ -1,9 +1,10 @@
 import type { Message } from "../../types/messages.js";
-import type { CompactionCutReason, CompactionEffectiveness } from "../../types/compaction.js";
+import type { CompactionCutReason, CompactionEffectiveness, CompactionReason, CompactionTrigger } from "../../types/compaction.js";
 import type { AgentContextFragmentApplyReport, AgentContextFragmentBuildContext, AgentContextFragmentBudgetOptions, AgentContextFragmentInput } from "../fragments/types.js";
 import type { ContextCompactionDecision } from "../window/decision.js";
 import type { ContextWindowStats } from "../window/manager.js";
-export type ModelContextCompactionPhase = "pre-step" | "recovery" | "post-turn";
+import type { ContextTokenEstimator } from "../window/estimation.js";
+export type ModelContextCompactionPhase = "pre-step" | "recovery" | "post-turn" | "manual";
 export interface ContextFragmentCollector {
     hasMiddleware?: boolean;
     collectContextFragments(context: AgentContextFragmentBuildContext): Promise<AgentContextFragmentInput[]>;
@@ -22,12 +23,15 @@ export interface ModelContextAssemblyOptions {
     contextFragmentBudget?: AgentContextFragmentBudgetOptions;
     window?: {
         getStats(messages: readonly Message[]): ContextWindowStats;
+        getTokenEstimator?(): ContextTokenEstimator | undefined;
     };
     compaction?: ModelContextCompactionReport;
 }
 export interface ModelContextCompactionReport {
     applied: boolean;
     phase: ModelContextCompactionPhase;
+    trigger?: CompactionTrigger;
+    reason?: CompactionReason;
     inputTokens: number;
     limit: number;
     decision: ContextCompactionDecision;

package/dist/context/assembly/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/context/assembly/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,+BAA+B,EAC/B,gCAAgC,EAChC,iCAAiC,EACjC,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,MAAM,2BAA2B,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAEhF,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uBAAuB,CACrB,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IACpD,gBAAgB,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACxD,qBAAqB,CAAC,EAAE,iCAAiC,CAAC;IAC1D,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,kBAAkB,CAAC;KAC5D,CAAC;IACF,UAAU,CAAC,EAAE,4BAA4B,CAAC;CAC3C;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,2BAA2B,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,yBAAyB,CAAC;IACpC,aAAa,EAAE,uBAAuB,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,gBAAgB,EAAE,+BAA+B,CAAC;IAClD,MAAM,EAAE;QACN,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAC5B,KAAK,CAAC,EAAE,kBAAkB,CAAC;KAC5B,CAAC;IACF,UAAU,CAAC,EAAE,4BAA4B,CAAC;CAC3C;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,0BAA0B,CAAC;CACpC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/context/assembly/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,+BAA+B,EAC/B,gCAAgC,EAChC,iCAAiC,EACjC,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,MAAM,2BAA2B,GACnC,UAAU,GACV,UAAU,GACV,WAAW,GACX,QAAQ,CAAC;AAEb,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uBAAuB,CACrB,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IACpD,gBAAgB,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACxD,qBAAqB,CAAC,EAAE,iCAAiC,CAAC;IAC1D,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,kBAAkB,CAAC;QAC3D,iBAAiB,CAAC,IAAI,qBAAqB,GAAG,SAAS,CAAC;KACzD,CAAC;IACF,UAAU,CAAC,EAAE,4BAA4B,CAAC;CAC3C;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,2BAA2B,CAAC;IACnC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,yBAAyB,CAAC;IACpC,aAAa,EAAE,uBAAuB,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,gBAAgB,EAAE,+BAA+B,CAAC;IAClD,MAAM,EAAE;QACN,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAC5B,KAAK,CAAC,EAAE,kBAAkB,CAAC;KAC5B,CAAC;IACF,UAAU,CAAC,EAAE,4BAA4B,CAAC;CAC3C;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,0BAA0B,CAAC;CACpC"}

package/dist/context/config.d.ts

@@ -1,3 +1,4 @@
+import type { ContextTokenEstimator } from "./window/index.js";
 export interface AgentContextConfig {
     /**
      * Maximum estimated tokens allowed for transient context fragments injected
@@ -6,6 +7,14 @@ export interface AgentContextConfig {
      * When omitted, the runtime uses a proportional cap based on the usable
      * context window.
      */
-    maxEstimatedFragmentTokens?: number;
+    maxFragmentTokens?: number;
+    /**
+     * Optional estimator used by context-window planning.
+     *
+     * Agent-core still treats these numbers as estimates. Provider usage
+     * metadata remains a lower bound when available, and provider overflow
+     * recovery is still the final safety net.
+     */
+    tokenEstimator?: ContextTokenEstimator;
 }
 //# sourceMappingURL=config.d.ts.map

package/dist/context/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/context/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/context/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC"}

package/dist/context/fragments/messages.d.ts

@@ -1,10 +1,12 @@
 import type { Message } from "../../types/messages.js";
+import { type ContextTokenEstimator } from "../window/estimation.js";
 import type { AgentContextFragmentApplyResult, AgentContextFragmentBudgetOptions, AgentContextFragmentInput, AgentContextFragmentMessageMetadata } from "./types.js";
 export declare function createAgentContextFragmentMessage(input: AgentContextFragmentInput): Message;
 export declare function getAgentContextFragmentMetadata(message: Message): AgentContextFragmentMessageMetadata | undefined;
 export declare function isAgentContextFragmentMessage(message: Message): boolean;
 export declare function applyAgentContextFragmentsWithReport(messages: readonly Message[], contextFragments?: readonly AgentContextFragmentInput[], options?: {
     budget?: AgentContextFragmentBudgetOptions;
+    tokenEstimator?: ContextTokenEstimator;
 }): AgentContextFragmentApplyResult;
 export declare function applyAgentContextFragments(messages: readonly Message[], contextFragments?: readonly AgentContextFragmentInput[]): Message[];
 //# sourceMappingURL=messages.d.ts.map

package/dist/context/fragments/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/context/fragments/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAOvD,OAAO,KAAK,EAEV,+BAA+B,EAC/B,iCAAiC,EACjC,yBAAyB,EAEzB,mCAAmC,EAIpC,MAAM,YAAY,CAAC;AAapB,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAWT;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,OAAO,GACf,mCAAmC,GAAG,SAAS,CASjD;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEvE;AA8GD,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,gBAAgB,GAAE,SAAS,yBAAyB,EAAO,EAC3D,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,iCAAiC,CAAA;CAAO,GAC3D,+BAA+B,CA6GjC;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,gBAAgB,GAAE,SAAS,yBAAyB,EAAO,GAC1D,OAAO,EAAE,CAGX"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/context/fragments/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AAMjC,OAAO,KAAK,EAEV,+BAA+B,EAC/B,iCAAiC,EACjC,yBAAyB,EAEzB,mCAAmC,EAIpC,MAAM,YAAY,CAAC;AAapB,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAWT;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,OAAO,GACf,mCAAmC,GAAG,SAAS,CASjD;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEvE;AA8GD,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,gBAAgB,GAAE,SAAS,yBAAyB,EAAO,EAC3D,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,iCAAiC,CAAC;IAC3C,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACnC,GACL,+BAA+B,CAgHjC;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,gBAAgB,GAAE,SAAS,yBAAyB,EAAO,GAC1D,OAAO,EAAE,CAGX"}