@superblocksteam/vite-plugin-file-sync 2.0.123 → 2.0.124-next.0

package/dist/ai-service/llm/context-v2/compaction/compaction-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-strategy.js","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context-v2/compaction/compaction-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/ai-service/llm/context-v2/compaction/index.d.ts

@@ -0,0 +1,5 @@
+export type { CompactionStrategy, CompactionStrategyResult, } from "./compaction-strategy.js";
+export { ClientSideCompactionStrategy } from "./client-side.js";
+export type { ClientSideCompactionOptions } from "./client-side.js";
+export { ServerSideCompactionStrategy } from "./server-side.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-service/llm/context-v2/compaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context-v2/compaction/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/ai-service/llm/context-v2/compaction/index.js

@@ -0,0 +1,3 @@
+export { ClientSideCompactionStrategy } from "./client-side.js";
+export { ServerSideCompactionStrategy } from "./server-side.js";
+//# sourceMappingURL=index.js.map

package/dist/ai-service/llm/context-v2/compaction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context-v2/compaction/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/ai-service/llm/context-v2/compaction/server-side.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Server-side compaction strategy that delegates to Anthropic's context management.
+ *
+ * Does not perform any local compaction. Instead, reacts to compaction events
+ * detected in response metadata by inserting a marker message.
+ */
+import type { LanguageModelUsage, ModelMessage } from "ai";
+import type { ContextOptionsV2 } from "../config.js";
+import type { StoredMessage, SuperblocksMetadata, CompactionSummary, CompactionCallbacks } from "../types.js";
+import type { CompactionStrategy, CompactionStrategyResult } from "./compaction-strategy.js";
+/**
+ * Compaction strategy that relies on Anthropic's server-side `clear_tool_uses`
+ * and `compact` edits. Locally, it only tracks protection flags and reacts
+ * to compaction detection by inserting a summary marker.
+ */
+export declare class ServerSideCompactionStrategy implements CompactionStrategy {
+    private pendingProtection;
+    updateConfig(_config: Partial<ContextOptionsV2>): void;
+    storeSummary(toolCallId: string, summary: CompactionSummary): void;
+    setCallbacks(_callbacks: CompactionCallbacks | undefined): void;
+    collectAssistantMetadata(_message: ModelMessage): Partial<SuperblocksMetadata> | undefined;
+    collectToolMetadata(message: ModelMessage): Partial<SuperblocksMetadata> | undefined;
+    afterResponse(_params: {
+        messages: StoredMessage[];
+        usage: LanguageModelUsage;
+    }): Promise<CompactionStrategyResult>;
+    onCompactionDetected(messages: StoredMessage[]): CompactionStrategyResult;
+    getProtectedToolNames(messages: StoredMessage[]): string[];
+}
+//# sourceMappingURL=server-side.d.ts.map

package/dist/ai-service/llm/context-v2/compaction/server-side.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-side.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context-v2/compaction/server-side.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAG3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAIlC;;;;GAIG;AACH,qBAAa,4BAA6B,YAAW,kBAAkB;IACrE,OAAO,CAAC,iBAAiB,CAAqB;IAE9C,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAItD,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAMlE,YAAY,CAAC,UAAU,EAAE,mBAAmB,GAAG,SAAS,GAAG,IAAI;IAI/D,wBAAwB,CACtB,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,mBAAmB,CAAC,GAAG,SAAS;IAI3C,mBAAmB,CACjB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,mBAAmB,CAAC,GAAG,SAAS;IAwBrC,aAAa,CAAC,OAAO,EAAE;QAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;QAC1B,KAAK,EAAE,kBAAkB,CAAC;KAC3B,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIrC,oBAAoB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,wBAAwB;IAiEzE,qBAAqB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE;CA6B3D"}

package/dist/ai-service/llm/context-v2/compaction/server-side.js

@@ -0,0 +1,130 @@
+/**
+ * Server-side compaction strategy that delegates to Anthropic's context management.
+ *
+ * Does not perform any local compaction. Instead, reacts to compaction events
+ * detected in response metadata by inserting a marker message.
+ */
+import { getPrefixedLogger } from "../../../../util/logger.js";
+const logger = getPrefixedLogger("[compaction:server-side]");
+/**
+ * Compaction strategy that relies on Anthropic's server-side `clear_tool_uses`
+ * and `compact` edits. Locally, it only tracks protection flags and reacts
+ * to compaction detection by inserting a summary marker.
+ */
+export class ServerSideCompactionStrategy {
+    pendingProtection = new Set();
+    updateConfig(_config) {
+        // No-op — server-side compaction holds no config that varies at runtime.
+    }
+    storeSummary(toolCallId, summary) {
+        if (summary.protected) {
+            this.pendingProtection.add(toolCallId);
+        }
+    }
+    setCallbacks(_callbacks) {
+        // No-op — server-side compaction has no client progress callbacks.
+    }
+    collectAssistantMetadata(_message) {
+        return undefined;
+    }
+    collectToolMetadata(message) {
+        if (message.role !== "tool" || !Array.isArray(message.content)) {
+            return undefined;
+        }
+        const toolCallIds = message.content
+            .filter((p) => p.type === "tool-result" && p.toolCallId)
+            .map((p) => p.toolCallId);
+        const protectedResults = {};
+        for (const id of toolCallIds) {
+            if (this.pendingProtection.has(id)) {
+                protectedResults[id] = true;
+                this.pendingProtection.delete(id);
+            }
+        }
+        return Object.keys(protectedResults).length > 0
+            ? { protected: protectedResults }
+            : undefined;
+    }
+    async afterResponse(_params) {
+        return {};
+    }
+    onCompactionDetected(messages) {
+        // Mirror what `JsonlEventStore.loadMessages` returns on a fresh load
+        // after a `compaction_received` event has been written: a compaction
+        // marker followed by everything from the current turn forward. Within
+        // an in-memory session we have to do this trim ourselves — leaving
+        // the full history in `this.messages` means every subsequent request
+        // re-sends all the pre-compact tokens, Anthropic re-applies
+        // `compact_20260112` on each turn, and the agent never converges
+        // (observed on PR #18617: a single anthropic eval ran 141 LLM steps,
+        // fired 146 compaction events, and timed out at the 30m job
+        // boundary). The session is supposed to live "after" the
+        // compaction anchor; this method makes that true in memory as well
+        // as on disk.
+        //
+        // Trim to the last user message because that marks the start of the
+        // current turn - the agent may be mid-flight on a tool call /
+        // tool-result chain we don't want to truncate. If a prior client-side
+        // phase-2 summary exists, retain the latest one as the compacted
+        // prefix for the earlier conversation. This lets sessions safely move
+        // client -> server -> client without the server-side trim erasing the
+        // only summary of pre-server history.
+        let lastUserIndex = -1;
+        for (let i = messages.length - 1; i >= 0; i--) {
+            if (messages[i]?.role === "user") {
+                lastUserIndex = i;
+                break;
+            }
+        }
+        if (lastUserIndex < 0) {
+            logger.warn("Server-side compaction detected but no user message present; skipping in-memory trim");
+            return { skillsNeedReload: true };
+        }
+        let lastSummaryIndex = -1;
+        for (let i = lastUserIndex - 1; i >= 0; i--) {
+            if (messages[i]?._superblocks?.isSummary === true) {
+                lastSummaryIndex = i;
+                break;
+            }
+        }
+        const marker = {
+            role: "system",
+            content: "Server-side compaction applied",
+            _superblocks: { timestamp: Date.now() },
+        };
+        const retainedPrefix = lastSummaryIndex >= 0 ? [messages[lastSummaryIndex]] : [];
+        const trimmed = [
+            marker,
+            ...retainedPrefix,
+            ...messages.slice(lastUserIndex),
+        ];
+        logger.info(`Server-side compaction detected; trimmed in-memory history ${messages.length} → ${trimmed.length} messages`);
+        return { messages: trimmed, skillsNeedReload: true };
+    }
+    getProtectedToolNames(messages) {
+        const toolNames = new Set();
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const msg = messages[i];
+            if (msg?.role !== "tool" ||
+                !msg._superblocks?.protected ||
+                !Array.isArray(msg.content)) {
+                continue;
+            }
+            for (const part of msg.content) {
+                if (typeof part === "object" &&
+                    part !== null &&
+                    "type" in part &&
+                    part.type === "tool-result" &&
+                    "toolCallId" in part &&
+                    "toolName" in part) {
+                    const toolCallId = part.toolCallId;
+                    if (msg._superblocks.protected[toolCallId]) {
+                        toolNames.add(part.toolName);
+                    }
+                }
+            }
+        }
+        return [...toolNames];
+    }
+}
+//# sourceMappingURL=server-side.js.map

package/dist/ai-service/llm/context-v2/compaction/server-side.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-side.js","sourceRoot":"","sources":["../../../../../src/ai-service/llm/context-v2/compaction/server-side.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/llm/context-v2/context-management.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Server-side context management configuration for Anthropic provider.
+ *
+ * Builds the `contextManagement` provider options for the `@ai-sdk/anthropic`
+ * SDK, enabling two server-side edit strategies:
+ *
+ * 1. `clear_tool_uses_20250919` -- removes old tool use/result pairs from
+ *    context when input tokens exceed a threshold, keeping recent ones and
+ *    excluding protected tools.
+ *
+ * 2. `compact_20260112` -- triggers server-side summarization when context
+ *    grows beyond a second threshold, with optional mode-preserving instructions.
+ */
+import type { JSONObject } from "@ai-sdk/provider";
+import type { LanguageModel } from "ai";
+import type { ServerContextManagementOptions } from "@superblocksteam/library-shared/types";
+/**
+ * Input token threshold at which old tool use/result pairs are cleared.
+ *
+ * Set below the compact trigger so tool clearing happens first, reducing
+ * context size without losing conversational continuity. 100k tokens is
+ * roughly 60-70% of a typical 150k context window.
+ */
+export declare const CLEAR_TOOL_USES_TRIGGER_TOKENS = 100000;
+/**
+ * Input token threshold at which server-side compaction (summarization) fires.
+ *
+ * Set higher than the clear trigger so compaction is a second line of defense.
+ * 150k tokens leaves headroom for the output budget in a 200k context window.
+ */
+export declare const COMPACT_TRIGGER_TOKENS = 150000;
+/**
+ * Number of recent tool use/result pairs to keep when clearing.
+ *
+ * Keeping 6 recent tool uses preserves the most recent multi-step
+ * tool call chain (e.g., read -> edit -> verify pattern).
+ */
+export declare const KEEP_RECENT_TOOL_USES = 6;
+/**
+ * Minimum number of input tokens to clear when the clear trigger fires.
+ *
+ * Prevents trivial clears that would break prompt caching by forcing
+ * each clear to reclaim at least 10k tokens of context. Without this,
+ * the server might clear a single small tool result and immediately
+ * invalidate the cache prefix.
+ */
+export declare const CLEAR_AT_LEAST_TOKENS = 10000;
+/**
+ * Client-side context management: compaction runs locally via Phase 1
+ * (tool output redaction) and Phase 2 (LLM session summarization).
+ */
+interface ClientContextManagement {
+    readonly type: "client";
+    /** Model used for Phase 2 summarization. */
+    readonly summarizationModel: LanguageModel;
+}
+/**
+ * Server-side context management: compaction is delegated to Anthropic's
+ * `clear_tool_uses` and `compact` edits sent via provider options.
+ */
+interface ServerContextManagement {
+    readonly type: "server";
+    /** Tool names to exclude from clear_tool_uses (e.g., protected system skill reads). */
+    readonly excludeTools?: readonly string[];
+    /** Instructions for the compaction summarizer (e.g., mode state to preserve). */
+    readonly modeInstructions?: string;
+    /** Threshold overrides for server-side context management (e.g., from LaunchDarkly). */
+    readonly thresholds?: Partial<ServerContextManagementOptions>;
+}
+/**
+ * Discriminated union for context management strategy selection.
+ *
+ * - `client`: compaction runs locally (Phase 1 + Phase 2 LLM summarization).
+ * - `server`: compaction is delegated to Anthropic's managed edits.
+ */
+export type ContextManagementOptions = ClientContextManagement | ServerContextManagement;
+/**
+ * Choose the compaction strategy for a request from the
+ * `serverContextManagement.enabled` LD-flag field.
+ *
+ * Defaults to client-side: only an explicit `enabled === true` flips
+ * to server-side (Anthropic's `compact_20260112` /
+ * `clear_tool_uses_20250919`). `enabled === false`, `enabled ===
+ * undefined`, and missing-flag payloads all resolve to client-side
+ * (phase 1 + phase 2 LLM session summarization). Opt-in by design
+ * because the server-side path is newer, only validated on Anthropic
+ * variants of the SDK, and its behavior on long sessions depends on
+ * the in-memory trim that `ServerSideCompactionStrategy` performs on
+ * compaction-detected — easier to roll forward with explicit gating
+ * than to roll back from a default-on regression.
+ *
+ * Lives here (not in clark-fsm) so it can be unit-tested independently
+ * of the FSM's heavyweight construction.
+ */
+export declare function selectContextManagementStrategy(options: {
+    serverContextManagementEnabled: boolean | undefined;
+    modeInstructions: string | undefined;
+    thresholds?: Partial<ServerContextManagementOptions>;
+    summarizationModel: () => LanguageModel;
+}): ContextManagementOptions;
+/**
+ * Internal options for `ContextManagementConfig.build()`.
+ *
+ * Decoupled from the public union because callers pass the discriminated
+ * union while `processLLMConfig` extracts and merges the fields needed
+ * by the config builder.
+ */
+export interface ContextManagementBuildOptions {
+    /** Tool names to exclude from clear_tool_uses (e.g., protected system skill reads). */
+    readonly excludeTools?: readonly string[];
+    /** Instructions for the compaction summarizer (e.g., mode state to preserve). */
+    readonly modeInstructions?: string;
+    /** LaunchDarkly-driven threshold overrides for server-side context management. */
+    readonly thresholds?: Partial<ServerContextManagementOptions>;
+}
+/** clear_tool_uses_20250919 edit: removes old tool use/result pairs. */
+interface ClearToolUsesEdit {
+    type: "clear_tool_uses_20250919";
+    trigger: {
+        type: "input_tokens";
+        value: number;
+    };
+    keep: {
+        type: "tool_uses";
+        value: number;
+    };
+    clearAtLeast: {
+        type: "input_tokens";
+        value: number;
+    };
+    clearToolInputs: boolean;
+    excludeTools?: string[];
+}
+/** compact_20260112 edit: summarizes the conversation in place. */
+interface CompactEdit {
+    type: "compact_20260112";
+    trigger: {
+        type: "input_tokens";
+        value: number;
+    };
+    instructions?: string;
+}
+/**
+ * Discriminated union over the edit shapes Anthropic's context management
+ * accepts. The flat form previously used here permitted nonsensical
+ * combinations (e.g. `compact_20260112` with `clearToolInputs`), making the
+ * contract ambiguous at the type level.
+ */
+type ContextManagementEdit = ClearToolUsesEdit | CompactEdit;
+/**
+ * Shape returned by `ContextManagementConfig.build()`.
+ *
+ * Uses `JSONObject` so it can be directly embedded in `providerOptions.anthropic`
+ * without type incompatibility with the AI SDK's `SharedV3ProviderOptions`.
+ */
+export type ContextManagementResult = JSONObject & {
+    edits: ContextManagementEdit[];
+};
+/**
+ * Bedrock beta feature flags required for context management.
+ *
+ * These are passed via `additionalModelRequestFields.anthropic_beta`
+ * in the Bedrock InvokeModel request body.
+ */
+export declare const BEDROCK_CONTEXT_MANAGEMENT_BETAS: readonly ["context-management-2025-06-27", "compact-2026-01-12"];
+/**
+ * Builds the Anthropic `contextManagement` provider options.
+ *
+ * This class encapsulates the configuration for server-side context
+ * management edits -- tool-use clearing and compaction. The output
+ * is passed as `providerOptions.anthropic.contextManagement` in
+ * `streamText` calls for direct Anthropic, and translated to
+ * `additionalModelRequestFields.context_management` for Bedrock.
+ */
+export declare class ContextManagementConfig {
+    /**
+     * Build the context management configuration for `providerOptions.anthropic`.
+     *
+     * The `@ai-sdk/anthropic` provider handles beta header injection and
+     * camelCase-to-snake_case translation automatically.
+     *
+     * @param options - Optional overrides for exclude lists and compaction instructions
+     * @returns The `contextManagement` object for `providerOptions.anthropic`
+     */
+    static build(options?: ContextManagementBuildOptions): ContextManagementResult;
+    /**
+     * Build the context management fields for `providerOptions.bedrock.additionalModelRequestFields`.
+     *
+     * Bedrock InvokeModel uses snake_case field names and requires explicit
+     * `anthropic_beta` array in the request body (not HTTP headers). This method
+     * returns the fields to merge into `additionalModelRequestFields`.
+     *
+     * @param options - Optional overrides for exclude lists and compaction instructions
+     * @returns Object with `context_management` and `anthropic_beta` for Bedrock
+     */
+    static buildForBedrock(options?: ContextManagementBuildOptions): JSONObject;
+    /**
+     * Build the shared edit entries used by both Anthropic and Bedrock formats.
+     */
+    private static buildEdits;
+}
+export {};
+//# sourceMappingURL=context-management.d.ts.map

package/dist/ai-service/llm/context-v2/context-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-management.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/llm/context-v2/context-management.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/llm/context-v2/context-management.js

@@ -0,0 +1,183 @@
+/**
+ * Server-side context management configuration for Anthropic provider.
+ *
+ * Builds the `contextManagement` provider options for the `@ai-sdk/anthropic`
+ * SDK, enabling two server-side edit strategies:
+ *
+ * 1. `clear_tool_uses_20250919` -- removes old tool use/result pairs from
+ *    context when input tokens exceed a threshold, keeping recent ones and
+ *    excluding protected tools.
+ *
+ * 2. `compact_20260112` -- triggers server-side summarization when context
+ *    grows beyond a second threshold, with optional mode-preserving instructions.
+ */
+/**
+ * Input token threshold at which old tool use/result pairs are cleared.
+ *
+ * Set below the compact trigger so tool clearing happens first, reducing
+ * context size without losing conversational continuity. 100k tokens is
+ * roughly 60-70% of a typical 150k context window.
+ */
+export const CLEAR_TOOL_USES_TRIGGER_TOKENS = 100_000;
+/**
+ * Input token threshold at which server-side compaction (summarization) fires.
+ *
+ * Set higher than the clear trigger so compaction is a second line of defense.
+ * 150k tokens leaves headroom for the output budget in a 200k context window.
+ */
+export const COMPACT_TRIGGER_TOKENS = 150_000;
+/**
+ * Number of recent tool use/result pairs to keep when clearing.
+ *
+ * Keeping 6 recent tool uses preserves the most recent multi-step
+ * tool call chain (e.g., read -> edit -> verify pattern).
+ */
+export const KEEP_RECENT_TOOL_USES = 6;
+/**
+ * Minimum number of input tokens to clear when the clear trigger fires.
+ *
+ * Prevents trivial clears that would break prompt caching by forcing
+ * each clear to reclaim at least 10k tokens of context. Without this,
+ * the server might clear a single small tool result and immediately
+ * invalidate the cache prefix.
+ */
+export const CLEAR_AT_LEAST_TOKENS = 10_000;
+/**
+ * Choose the compaction strategy for a request from the
+ * `serverContextManagement.enabled` LD-flag field.
+ *
+ * Defaults to client-side: only an explicit `enabled === true` flips
+ * to server-side (Anthropic's `compact_20260112` /
+ * `clear_tool_uses_20250919`). `enabled === false`, `enabled ===
+ * undefined`, and missing-flag payloads all resolve to client-side
+ * (phase 1 + phase 2 LLM session summarization). Opt-in by design
+ * because the server-side path is newer, only validated on Anthropic
+ * variants of the SDK, and its behavior on long sessions depends on
+ * the in-memory trim that `ServerSideCompactionStrategy` performs on
+ * compaction-detected — easier to roll forward with explicit gating
+ * than to roll back from a default-on regression.
+ *
+ * Lives here (not in clark-fsm) so it can be unit-tested independently
+ * of the FSM's heavyweight construction.
+ */
+export function selectContextManagementStrategy(options) {
+    if (options.serverContextManagementEnabled === true) {
+        return {
+            type: "server",
+            ...(options.modeInstructions !== undefined && {
+                modeInstructions: options.modeInstructions,
+            }),
+            ...(options.thresholds !== undefined && {
+                thresholds: options.thresholds,
+            }),
+        };
+    }
+    return {
+        type: "client",
+        summarizationModel: options.summarizationModel(),
+    };
+}
+/**
+ * Bedrock beta feature flags required for context management.
+ *
+ * These are passed via `additionalModelRequestFields.anthropic_beta`
+ * in the Bedrock InvokeModel request body.
+ */
+export const BEDROCK_CONTEXT_MANAGEMENT_BETAS = [
+    "context-management-2025-06-27",
+    "compact-2026-01-12",
+];
+/**
+ * Builds the Anthropic `contextManagement` provider options.
+ *
+ * This class encapsulates the configuration for server-side context
+ * management edits -- tool-use clearing and compaction. The output
+ * is passed as `providerOptions.anthropic.contextManagement` in
+ * `streamText` calls for direct Anthropic, and translated to
+ * `additionalModelRequestFields.context_management` for Bedrock.
+ */
+export class ContextManagementConfig {
+    /**
+     * Build the context management configuration for `providerOptions.anthropic`.
+     *
+     * The `@ai-sdk/anthropic` provider handles beta header injection and
+     * camelCase-to-snake_case translation automatically.
+     *
+     * @param options - Optional overrides for exclude lists and compaction instructions
+     * @returns The `contextManagement` object for `providerOptions.anthropic`
+     */
+    static build(options) {
+        const edits = ContextManagementConfig.buildEdits(options);
+        return { edits };
+    }
+    /**
+     * Build the context management fields for `providerOptions.bedrock.additionalModelRequestFields`.
+     *
+     * Bedrock InvokeModel uses snake_case field names and requires explicit
+     * `anthropic_beta` array in the request body (not HTTP headers). This method
+     * returns the fields to merge into `additionalModelRequestFields`.
+     *
+     * @param options - Optional overrides for exclude lists and compaction instructions
+     * @returns Object with `context_management` and `anthropic_beta` for Bedrock
+     */
+    static buildForBedrock(options) {
+        const edits = ContextManagementConfig.buildEdits(options);
+        // Bedrock uses snake_case in the InvokeModel request body
+        const bedrockEdits = edits.map((edit) => {
+            if (edit.type === "clear_tool_uses_20250919") {
+                return {
+                    type: edit.type,
+                    trigger: edit.trigger,
+                    keep: edit.keep,
+                    clear_at_least: edit.clearAtLeast,
+                    clear_tool_inputs: edit.clearToolInputs,
+                    ...(edit.excludeTools && { exclude_tools: edit.excludeTools }),
+                };
+            }
+            // compact_20260112 fields are already snake_case compatible
+            return edit;
+        });
+        return {
+            context_management: { edits: bedrockEdits },
+            anthropic_beta: [...BEDROCK_CONTEXT_MANAGEMENT_BETAS],
+        };
+    }
+    /**
+     * Build the shared edit entries used by both Anthropic and Bedrock formats.
+     */
+    static buildEdits(options) {
+        const t = options?.thresholds;
+        const excludeTools = options?.excludeTools && options.excludeTools.length > 0
+            ? [...options.excludeTools]
+            : undefined;
+        const clearToolUsesEdit = {
+            type: "clear_tool_uses_20250919",
+            trigger: {
+                type: "input_tokens",
+                value: t?.clearToolUsesTriggerTokens ?? CLEAR_TOOL_USES_TRIGGER_TOKENS,
+            },
+            keep: {
+                type: "tool_uses",
+                value: t?.keepRecentToolUses ?? KEEP_RECENT_TOOL_USES,
+            },
+            clearAtLeast: {
+                type: "input_tokens",
+                value: t?.clearAtLeastTokens ?? CLEAR_AT_LEAST_TOKENS,
+            },
+            clearToolInputs: false,
+            ...(excludeTools && { excludeTools }),
+        };
+        const compactEdit = {
+            type: "compact_20260112",
+            trigger: {
+                type: "input_tokens",
+                value: t?.compactTriggerTokens ?? COMPACT_TRIGGER_TOKENS,
+            },
+            ...(options?.modeInstructions && {
+                instructions: options.modeInstructions,
+            }),
+        };
+        return [clearToolUsesEdit, compactEdit];
+    }
+}
+//# sourceMappingURL=context-management.js.map

package/dist/ai-service/llm/context-v2/context-management.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-management.js","sourceRoot":"","sources":["../../../../src/ai-service/llm/context-v2/context-management.ts"],"names":[],"mappings":"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"}