@ai-agent-forge/agent-forge 0.86.7 → 0.87.0

package/dist/core/agent-session-compaction.js

@@ -16,6 +16,7 @@ import { formatNoApiKeyFoundMessage, formatNoModelSelectedMessage } from "./auth
 import { calculateContextTokens, collectEntriesForBranchSummary, effectiveKeepRecentTokens, estimateContextTokens, estimateTokens, isTurnStartMessage, } from "./compaction/index.js";
 import { DEFAULT_COMPACTION_POLICY_NAME, SESSION_COMPACTION_COMMIT_EVENT_ID, SESSION_COMPACTION_COMMIT_EVENT_VERSION, } from "./extensions/index.js";
 import { SUMMARY_MODEL_INVOCATION_ERROR_CODES } from "./extensions/public-api.js";
+import { t } from "./i18n/index.js";
 import { getLatestCompactionEntry } from "./session-manager.js";
 function withoutDeletedHeaders(headers) {
     return headers
@@ -135,9 +136,7 @@ export async function getRequiredRequestAuth(session, model, signal) {
     }
     const isOAuth = session._modelRuntime.isUsingOAuth(model.provider);
     if (isOAuth) {
-        throw new Error(`Authentication failed for "${model.provider}". ` +
-            `Credentials may have expired or network is unavailable. ` +
-            `Run '/login ${model.provider}' to re-authenticate.`);
+        throw new Error(t("Authentication failed for \"{provider}\". Credentials may have expired or network is unavailable. Run '/login {provider}' to re-authenticate.", { provider: model.provider }));
     }
     throw new Error(formatNoApiKeyFoundMessage(model.provider));
 }
@@ -368,7 +367,7 @@ export async function runCompactionSummary(session, preparation, auth, customIns
     const runtime = session._capabilityRuntime;
     // v8 ignore next -- capability runtime 恒由 _buildRuntime 创建，dispose 后不再调用，运行期恒存在
     if (!runtime)
-        throw new Error("Capability runtime is not available");
+        throw new Error(t("Capability runtime is not available"));
     const result = await runtime.summarizeCompaction(session._compactionPolicyName, {
         preparation,
         model: summaryModelFacts(auth.model),
@@ -421,7 +420,7 @@ export async function decideCompaction(session, input) {
     const runtime = session._capabilityRuntime;
     // v8 ignore next -- capability runtime 恒由 _buildRuntime 创建，dispose 后不再调用，运行期恒存在
     if (!runtime)
-        throw new Error("Capability runtime is not available");
+        throw new Error(t("Capability runtime is not available"));
     // 内核机制兜底：默认策略名且无人注册（默认插件被禁用或失败隔离）时，机制层
     // 不做压缩决策（无执行者），回合继续；缺失经 warn 日志与手动 /compact 的显式
     // 错误暴露。默认插件不得成为隐藏前提（宪法 §2/§5）。显式配置的其他策略名缺
@@ -446,7 +445,7 @@ export async function prepareCompaction(session, pathEntries, settings, executio
     const runtime = session._capabilityRuntime;
     // v8 ignore next -- capability runtime 恒由 _buildRuntime 创建，dispose 后不再调用，运行期恒存在
     if (!runtime)
-        throw new Error("Capability runtime is not available");
+        throw new Error(t("Capability runtime is not available"));
     const preparation = await runtime.prepareCompaction(session._compactionPolicyName, {
         entries: pathEntries,
         settings,
@@ -466,7 +465,9 @@ export async function prepareCompaction(session, pathEntries, settings, executio
         !Number.isFinite(value.tokensBefore) ||
         typeof value.fileOps !== "object" ||
         typeof value.settings !== "object") {
-        throw new Error(`Compaction policy returned an invalid preparation: ${session._compactionPolicyName}`);
+        throw new Error(t("Compaction policy returned an invalid preparation: {policyName}", {
+            policyName: session._compactionPolicyName,
+        }));
     }
     return preparation;
 }
@@ -490,7 +491,7 @@ export function enqueueCompaction(session, operation) {
     const queued = previous
         .then(() => {
         if (session._reloadInProgress) {
-            throw new Error("Session reload in progress; compaction was not started");
+            throw new Error(t("Session reload in progress; compaction was not started"));
         }
         return operation();
     })
@@ -525,11 +526,16 @@ export function commitCompaction(session, input) {
         usage: input.usage,
     });
     if (commit.status === "revision_conflict") {
-        throw new Error(`Compaction commit revision conflict: expected ${input.expectedRevision.sequence}/${input.expectedRevision.leafId ?? "root"}, current ${commit.currentRevision.sequence}/${commit.currentRevision.leafId ?? "root"}`);
+        throw new Error(t("Compaction commit revision conflict: expected {expectedSequence}/{expectedLeafId}, current {currentSequence}/{currentLeafId}", {
+            expectedSequence: input.expectedRevision.sequence,
+            expectedLeafId: input.expectedRevision.leafId ?? "root",
+            currentSequence: commit.currentRevision.sequence,
+            currentLeafId: commit.currentRevision.leafId ?? "root",
+        }));
     }
     const entry = session.sessionManager.getEntry(commit.entryId);
     if (entry?.type !== "compaction" || entry.operationId !== input.operationId) {
-        throw new Error(`Compaction commit entry is unavailable: ${commit.entryId}`);
+        throw new Error(t("Compaction commit entry is unavailable: {entryId}", { entryId: commit.entryId }));
     }
     return { entry, status: commit.status, revision: commit.revision };
 }
@@ -539,7 +545,7 @@ export async function dispatchCompactionCommitLifecycle(session, reason, commit)
         const runtime = session._capabilityRuntime;
         // v8 ignore next -- capability runtime 恒由 _buildRuntime 创建，dispose 后不再调用，运行期恒存在
         if (!runtime)
-            throw new Error("Capability runtime is not available");
+            throw new Error(t("Capability runtime is not available"));
         const entry = commit.entry;
         const data = {
             version: 1,
@@ -584,7 +590,7 @@ export async function decideOverflow(session, message, execution, signal) {
     const runtime = session._capabilityRuntime;
     // v8 ignore next -- capability runtime 恒由 _buildRuntime 创建，dispose 后不再调用，运行期恒存在
     if (!runtime)
-        throw new Error("Capability runtime is not available");
+        throw new Error(t("Capability runtime is not available"));
     return runtime.decideOverflow(session._overflowPolicyName, {
         message,
         contextWindow: session.model?.contextWindow,
@@ -634,9 +640,9 @@ export async function compactInternal(session, customInstructions) {
             // Check why we can't compact
             const lastEntry = pathEntries[pathEntries.length - 1];
             if (lastEntry?.type === "compaction") {
-                throw new Error("Already compacted");
+                throw new Error(t("Already compacted"));
             }
-            throw new Error("Nothing to compact (session too small)");
+            throw new Error(t("Nothing to compact (session too small)"));
         }
         // Shared default summary generator, also used by automatic compaction.
         const { summary, firstKeptEntryId, tokensBefore, usage, details } = await runCompactionSummary(session, preparation, auth, customInstructions, session._compactionAbortController.signal, "manual", execution);
@@ -1203,7 +1209,7 @@ export function summarizationRetryPolicy(session, operationId, inputRevision, si
     const runtime = session._capabilityRuntime;
     // v8 ignore next -- capability runtime 恒由 _buildRuntime 创建，dispose 后不再调用，运行期恒存在
     if (!runtime)
-        throw new Error("Capability runtime is not available");
+        throw new Error(t("Capability runtime is not available"));
     const execution = executionFacts(session, "retry", operationId ? `${operationId}:retry` : undefined, inputRevision);
     return {
         ...settings,
@@ -1240,11 +1246,11 @@ export function summarizationRetryPolicy(session, operationId, inputRevision, si
  */
 export async function navigateTree(session, targetId, options = {}) {
     if (session.isStreaming) {
-        throw new Error("Wait for the current response to finish before navigating the session tree.");
+        throw new Error(t("Wait for the current response to finish before navigating the session tree."));
     }
     // Compaction mutates the active branch; navigating mid-compaction would race the summary commit.
     if (session._compactionAbortController !== undefined || session._autoCompactionAbortController !== undefined) {
-        throw new Error("Wait for the current compaction or tree navigation to finish before navigating the session tree.");
+        throw new Error(t("Wait for the current compaction or tree navigation to finish before navigating the session tree."));
     }
     const oldLeafId = session.sessionManager.getLeafId();
     // No-op if already at target
@@ -1253,11 +1259,11 @@ export async function navigateTree(session, targetId, options = {}) {
     }
     // Model required for summarization
     if (options.summarize && !session.model) {
-        throw new Error("No model available for summarization");
+        throw new Error(t("No model available for summarization"));
     }
     const targetEntry = session.sessionManager.getEntry(targetId);
     if (!targetEntry) {
-        throw new Error(`Entry ${targetId} not found`);
+        throw new Error(t("Entry {id} not found", { id: targetId }));
     }
     // Collect entries to summarize (from old leaf to common ancestor)
     const { entries: entriesToSummarize } = collectEntriesForBranchSummary(session.sessionManager, oldLeafId, targetId);
@@ -1265,10 +1271,10 @@ export async function navigateTree(session, targetId, options = {}) {
     const replaceInstructions = options.replaceInstructions;
     const label = options.label;
     if (session._reloadInProgress) {
-        throw new Error("Session reload in progress; tree navigation is unavailable");
+        throw new Error(t("Session reload in progress; tree navigation is unavailable"));
     }
     if (session._branchSummaryAbortController) {
-        throw new Error("Branch navigation is already in progress");
+        throw new Error(t("Branch navigation is already in progress"));
     }
     // Set up abort controller for summarization
     session._branchSummaryAbortController = new AbortController();
@@ -1287,7 +1293,7 @@ export async function navigateTree(session, targetId, options = {}) {
             const branchSummarySettings = session.settingsManager.getBranchSummarySettings();
             const runtime = session._capabilityRuntime;
             if (!runtime || !runtime.hasBranchSummaryPolicy(session._branchSummaryPolicyName)) {
-                throw new Error(`Branch summary policy is not registered: ${session._branchSummaryPolicyName}`);
+                throw new Error(t("Branch summary policy is not registered: {name}", { name: session._branchSummaryPolicyName }));
             }
             const execution = executionFacts(session, "branch_summary", `branch_summary:${session.sessionId}:${oldLeafId ?? "root"}:${targetId}`);
             const result = await runtime.summarizeBranch(session._branchSummaryPolicyName, {