agents 0.22.0 → 0.23.0

package/package.json

@@ -9,7 +9,7 @@
     "durable objects"
   ],
   "type": "module",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "license": "MIT",
   "repository": {
     "directory": "packages/agents",
@@ -24,17 +24,19 @@
     "@babel/plugin-proposal-decorators": "^8.0.2",
     "@cfworker/json-schema": "^4.1.1",
     "@rolldown/plugin-babel": "^0.2.3",
+    "capnweb": "^0.12.0",
     "cron-schedule": "^6.0.0",
     "esbuild": "^0.28.1",
     "mimetext": "^3.0.28",
     "nanoid": "^5.1.16",
     "partysocket": "1.3.0",
+    "postal-mime": "^2.7.5",
     "yaml": "^2.9.0"
   },
   "devDependencies": {
     "@ai-sdk/react": "^4.0.0",
     "@ai-sdk/valibot": "3.0.6",
-    "@cloudflare/codemode": "^0.5.1",
+    "@cloudflare/codemode": "^0.5.2",
     "@modelcontextprotocol/client": "2.0.0",
     "@modelcontextprotocol/conformance-v2": "npm:@modelcontextprotocol/conformance@0.2.0-alpha.10",
     "@modelcontextprotocol/sdk": "1.30.0",
@@ -49,8 +51,9 @@
     "glob": "^13.0.6",
     "just-bash": "^3.0.2",
     "react": "^19.2.7",
+    "teleproto": "^1.228.5",
     "valibot": "1.4.1",
-    "zod": "^4.4.3"
+    "zod": "^4.5.4"
   },
   "peerDependencies": {
     "@ai-sdk/react": "^3.0.0 || ^4.0.0",
@@ -117,6 +120,31 @@
       "import": "./dist/client.js",
       "require": "./dist/client.js"
     },
+    "./routing": {
+      "types": "./dist/routing/index.d.ts",
+      "import": "./dist/routing/index.js",
+      "require": "./dist/routing/index.js"
+    },
+    "./streams": {
+      "types": "./dist/streams/index.d.ts",
+      "import": "./dist/streams/index.js",
+      "require": "./dist/streams/index.js"
+    },
+    "./context": {
+      "types": "./dist/context/index.d.ts",
+      "import": "./dist/context/index.js",
+      "require": "./dist/context/index.js"
+    },
+    "./sessions": {
+      "types": "./dist/sessions/index.d.ts",
+      "import": "./dist/sessions/index.js",
+      "require": "./dist/sessions/index.js"
+    },
+    "./tasks": {
+      "types": "./dist/tasks/index.d.ts",
+      "import": "./dist/tasks/index.js",
+      "require": "./dist/tasks/index.js"
+    },
     "./lifecycle": {
       "types": "./dist/lifecycle/index.d.ts",
       "import": "./dist/lifecycle/index.js",
@@ -167,6 +195,11 @@
       "import": "./dist/react.js",
       "require": "./dist/react.js"
     },
+    "./websockets": {
+      "types": "./dist/websockets/index.d.ts",
+      "import": "./dist/websockets/index.js",
+      "require": "./dist/websockets/index.js"
+    },
     "./schedule": {
       "types": "./dist/schedule.d.ts",
       "import": "./dist/schedule.js",
@@ -187,16 +220,6 @@
       "import": "./dist/workflows.js",
       "require": "./dist/workflows.js"
     },
-    "./experimental/memory/session": {
-      "types": "./dist/experimental/memory/session/index.d.ts",
-      "import": "./dist/experimental/memory/session/index.js",
-      "require": "./dist/experimental/memory/session/index.js"
-    },
-    "./experimental/memory/utils": {
-      "types": "./dist/experimental/memory/utils/index.d.ts",
-      "import": "./dist/experimental/memory/utils/index.js",
-      "require": "./dist/experimental/memory/utils/index.js"
-    },
     "./experimental/webmcp": {
       "types": "./dist/experimental/webmcp.d.ts",
       "import": "./dist/experimental/webmcp.js",
@@ -267,6 +290,81 @@
       "import": "./dist/browser/tanstack-ai.js",
       "require": "./dist/browser/tanstack-ai.js"
     },
+    "./voice": {
+      "types": "./dist/voice/index.d.ts",
+      "import": "./dist/voice/index.js",
+      "require": "./dist/voice/index.js"
+    },
+    "./voice/types": {
+      "types": "./dist/voice/types.d.ts",
+      "import": "./dist/voice/types.js",
+      "require": "./dist/voice/types.js"
+    },
+    "./voice/client": {
+      "types": "./dist/voice/client.d.ts",
+      "import": "./dist/voice/client.js",
+      "require": "./dist/voice/client.js"
+    },
+    "./voice/react": {
+      "types": "./dist/voice/react.d.ts",
+      "import": "./dist/voice/react.js",
+      "require": "./dist/voice/react.js"
+    },
+    "./voice/errors": {
+      "types": "./dist/voice/errors.d.ts",
+      "import": "./dist/voice/errors.js",
+      "require": "./dist/voice/errors.js"
+    },
+    "./voice/workers-ai": {
+      "types": "./dist/voice/workers-ai.d.ts",
+      "import": "./dist/voice/workers-ai.js",
+      "require": "./dist/voice/workers-ai.js"
+    },
+    "./voice/sfu": {
+      "types": "./dist/voice/sfu.d.ts",
+      "import": "./dist/voice/sfu.js",
+      "require": "./dist/voice/sfu.js"
+    },
+    "./voice/text": {
+      "types": "./dist/voice/text.d.ts",
+      "import": "./dist/voice/text.js",
+      "require": "./dist/voice/text.js"
+    },
+    "./channels": {
+      "types": "./dist/channels/index.d.ts",
+      "import": "./dist/channels/index.js",
+      "require": "./dist/channels/index.js"
+    },
+    "./channels/email": {
+      "types": "./dist/channels/email.d.ts",
+      "import": "./dist/channels/email.js",
+      "require": "./dist/channels/email.js"
+    },
+    "./channels/slack": {
+      "types": "./dist/channels/slack.d.ts",
+      "import": "./dist/channels/slack.js",
+      "require": "./dist/channels/slack.js"
+    },
+    "./channels/telegram": {
+      "types": "./dist/channels/telegram.d.ts",
+      "import": "./dist/channels/telegram.js",
+      "require": "./dist/channels/telegram.js"
+    },
+    "./channels/voice": {
+      "types": "./dist/channels/voice.d.ts",
+      "import": "./dist/channels/voice.js",
+      "require": "./dist/channels/voice.js"
+    },
+    "./channels/ai-sdk": {
+      "types": "./dist/channels/ai-sdk.d.ts",
+      "import": "./dist/channels/ai-sdk.js",
+      "require": "./dist/channels/ai-sdk.js"
+    },
+    "./channels/tanstack-ai": {
+      "types": "./dist/channels/tanstack-ai.d.ts",
+      "import": "./dist/channels/tanstack-ai.js",
+      "require": "./dist/channels/tanstack-ai.js"
+    },
     "./tsconfig": "./agents.tsconfig.json",
     "./vite": {
       "types": "./dist/vite.d.ts",
@@ -319,6 +417,10 @@
     "test": "vitest --run",
     "test:node": "vitest --project node",
     "test:react": "vitest --project react",
+    "test:voice:workers": "vitest --project voice-workers",
+    "test:voice:react": "vitest --project voice-react",
+    "test:channels": "vitest --project channels",
+    "test:channels:live": "vitest --run -c src/channels/vitest.live.config.ts",
     "test:browser": "vitest run --config src/browser-tests/vitest.config.ts",
     "test:workers": "vitest --project workers",
     "test:chat": "vitest --project chat",

package/dist/capability-runner-CvHGZqUu.d.ts

@@ -1,150 +0,0 @@
-//#region src/lifecycle/capability.d.ts
-/** Opaque address understood by a Lifecycle routing transport. */
-type LifecycleRouteAddress = {
-  /** Stable equality and storage key. */ readonly key: string /** Transport-owned serialized address. */;
-  readonly data: string;
-};
-/** Context supplied with a routed capability message. */
-type LifecycleRouteContext = {
-  /** Address of the sending Lifecycle, or undefined for an unrouted root. */ readonly source:
-    | LifecycleRouteAddress
-    | undefined /** Capability-owned message payload. */;
-  readonly payload: unknown;
-};
-/** Alarm coordination available to every Lifecycle capability. */
-type LifecycleAlarms = {
-  /** Recompute the physical alarm from installed capability state. */ readonly rearm: () => Promise<void>;
-  /**
-   * True once explicit host teardown permanently disabled alarm arming.
-   * Capabilities stop dispatching durable work when this reports true.
-   */
-  readonly disabled: () => boolean;
-};
-/** Best-effort telemetry available to every Lifecycle capability. */
-type LifecycleEvents = {
-  /** Publish an event under this capability's stable identity. */ readonly emit: (
-    type: string,
-    payload: unknown
-  ) => void;
-};
-/** Routing available to every Lifecycle capability. */
-type LifecycleRoutes = {
-  /** This Lifecycle's transport address, or undefined at the route root. */ readonly source:
-    | LifecycleRouteAddress
-    | undefined /** Route a capability-owned message to the root Lifecycle. */;
-  readonly toRoot: (
-    payload: unknown
-  ) => Promise<unknown> /** Route a capability-owned message to another Lifecycle. */;
-  readonly to: (
-    target: LifecycleRouteAddress,
-    payload: unknown
-  ) => Promise<unknown>;
-};
-/**
- * Standard services granted to every installed Lifecycle capability.
- *
- * @experimental The API surface may change before stabilizing.
- */
-type LifecycleServices = {
-  readonly storage: DurableObjectStorage;
-  readonly ready: () => Promise<void> /** True while capability and host startup hooks are still running. */;
-  readonly starting: () => boolean;
-  readonly alarms: LifecycleAlarms;
-  /**
-   * Run a capability-held user callback inside the host invocation context.
-   * Capability hooks run outside host context; this is the one boundary for
-   * entering it, and a host composition root may substitute its own wrapper
-   * (Agent adds tracing span scope).
-   */
-  readonly runInHostContext: (fn: () => unknown) => Promise<unknown>;
-  readonly events: LifecycleEvents;
-  readonly routes: LifecycleRoutes;
-};
-/**
- * Base class for capabilities that consume standard Lifecycle services.
- *
- * @experimental The API surface may change before stabilizing.
- */
-declare abstract class LifecycleCapability<Props extends object = object> {
-  readonly capabilityId: string;
-  protected constructor(capabilityId: string);
-  /** Default startup hook; capabilities override when they own startup work. */
-  onStart(_context: CapabilityStartContext<Props>): void;
-  /** Standard services when installed, or undefined in isolated unit tests. */
-  protected get lifecycleServices(): LifecycleServices | undefined;
-  /** Standard services supplied when Lifecycle installs this capability. */
-  protected get lifecycle(): LifecycleServices;
-}
-//#endregion
-//#region src/lifecycle/capability-runner.d.ts
-type MaybePromise<T> = T | Promise<T>;
-/** One capability's requested physical alarm. */
-type AlarmContribution =
-  | number
-  | {
-      /** Epoch time in milliseconds. */ readonly time: number /** Ignore ordinary wake-time candidates while this request exists. */;
-      readonly exclusive: true;
-    }
-  | null;
-/** One best-effort event published by a Lifecycle capability. */
-type LifecycleEvent = {
-  /** Stable capability or subsystem name. */ readonly source: string /** Stable event name within that source. */;
-  readonly type: string /** Event-specific data. */;
-  readonly payload: unknown;
-};
-/** Context supplied when durable capabilities start. */
-type CapabilityStartContext<Props extends object = object> = {
-  /** Properties supplied while resolving the Durable Object. */ readonly props:
-    | Props
-    | undefined;
-};
-/** Context supplied when durable capabilities inspect an HTTP request. */
-type CapabilityRequestContext = {
-  /** The request entering the Durable Object. */ readonly request: Request;
-};
-/**
- * A capability installed into a Durable Object lifecycle.
- *
- * Capabilities extending `LifecycleCapability` receive the standard storage,
- * readiness, alarm, event, and routing surface. Host-specific bindings and
- * protocol adapters remain explicit constructor dependencies. Hook parameters
- * carry only phase data; hooks do not run in ambient host context.
- *
- * @experimental The API surface may change before stabilizing.
- */
-interface DurableObjectCapability<Props extends object = object> {
-  /** Initialize or recover the capability before the host handles work. */
-  onStart?(context: CapabilityStartContext<Props>): MaybePromise<void>;
-  /**
-   * Inspect an HTTP request before the host's request handler.
-   *
-   * Return a response to handle the request, or `undefined` to continue.
-   */
-  onRequest?(
-    context: CapabilityRequestContext
-  ): MaybePromise<Response | undefined | void>;
-  /** Run work assigned to the capability when the host's alarm fires. */
-  onAlarm?(): MaybePromise<void>;
-  /** Handle one message routed to this capability identity. */
-  onRoute?(context: LifecycleRouteContext): MaybePromise<unknown>;
-  /** Return this capability's next requested physical alarm. */
-  getNextAlarm?(): MaybePromise<AlarmContribution>;
-  /** Release live or in-memory resources during explicit host destruction. */
-  dispose?(): MaybePromise<void>;
-}
-//#endregion
-export {
-  LifecycleEvent as a,
-  LifecycleEvents as c,
-  LifecycleRoutes as d,
-  LifecycleServices as f,
-  DurableObjectCapability as i,
-  LifecycleRouteAddress as l,
-  CapabilityRequestContext as n,
-  LifecycleAlarms as o,
-  CapabilityStartContext as r,
-  LifecycleCapability as s,
-  AlarmContribution as t,
-  LifecycleRouteContext as u
-};
-//# sourceMappingURL=capability-runner-CvHGZqUu.d.ts.map

package/dist/compaction-helpers-iiKMr2TQ.js

@@ -1,340 +0,0 @@
-//#region src/experimental/memory/utils/tokens.ts
-/** Approximate characters per token for English text */
-const CHARS_PER_TOKEN = 4;
-/** Approximate token multiplier per whitespace-separated word */
-const WORDS_TOKEN_MULTIPLIER = 1.3;
-/** Approximate overhead tokens per message (role, framing) */
-const TOKENS_PER_MESSAGE = 4;
-/**
-* Estimate token count for a string using a hybrid heuristic.
-*
-* Takes the max of two estimates:
-* - Character-based: `length / 4` — better for dense content (JSON, code, URLs)
-* - Word-based: `words * 1.3` — better for natural language prose
-*
-* This is a heuristic. Do not use where exact counts are required.
-*/
-function estimateStringTokens(text) {
-	if (!text) return 0;
-	const charEstimate = text.length / 4;
-	const wordEstimate = text.split(/\s+/).filter(Boolean).length * WORDS_TOKEN_MULTIPLIER;
-	return Math.ceil(Math.max(charEstimate, wordEstimate));
-}
-function estimateUnknownTokens(value) {
-	if (value === null || value === void 0) return 0;
-	if (typeof value === "string") return estimateStringTokens(value);
-	try {
-		return estimateStringTokens(JSON.stringify(value));
-	} catch {
-		return estimateStringTokens(String(value));
-	}
-}
-/**
-* Estimate total token count for an array of UIMessages.
-*
-* Walks each message's parts (text, reasoning, tool invocations, tool results)
-* and applies per-message overhead.
-*
-* This is a heuristic. Do not use where exact counts are required.
-*/
-function estimateMessageTokens(messages) {
-	let tokens = 0;
-	for (const msg of messages) {
-		tokens += 4;
-		for (const part of msg.parts) if (part.type === "text" || part.type === "reasoning") tokens += estimateUnknownTokens(part.text ?? part.reasoning);
-		else if (part.type.startsWith("tool-") || part.type === "dynamic-tool") {
-			tokens += estimateUnknownTokens(part.input);
-			tokens += estimateUnknownTokens(part.output ?? part.result);
-		} else if (part.text !== void 0) tokens += estimateUnknownTokens(part.text);
-		else if (part.result !== void 0) tokens += estimateUnknownTokens(part.result);
-	}
-	return tokens;
-}
-//#endregion
-//#region src/experimental/memory/utils/compaction-helpers.ts
-/** Prefix for all compaction messages (overlays and summaries) */
-const COMPACTION_PREFIX = "compaction_";
-/** Check if a message is a compaction message */
-function isCompactionMessage(msg) {
-	return msg.id.startsWith(COMPACTION_PREFIX);
-}
-/**
-* Check if a message contains tool invocations.
-*/
-function hasToolCalls(msg) {
-	return msg.parts.some((p) => p.type.startsWith("tool-") || p.type === "dynamic-tool");
-}
-/**
-* Get tool call IDs from a message's parts.
-*/
-function getToolCallIds(msg) {
-	const ids = /* @__PURE__ */ new Set();
-	for (const part of msg.parts) if ((part.type.startsWith("tool-") || part.type === "dynamic-tool") && "toolCallId" in part) ids.add(part.toolCallId);
-	return ids;
-}
-/**
-* Check if a message is a tool result referencing a specific call ID.
-*/
-function isToolResultFor(msg, callIds) {
-	return msg.parts.some((p) => (p.type.startsWith("tool-") || p.type === "dynamic-tool") && "toolCallId" in p && callIds.has(p.toolCallId));
-}
-/**
-* Align a boundary index forward to avoid splitting tool call/result groups.
-* If the boundary falls between an assistant message with tool calls and its
-* tool results, move it forward past the results.
-*/
-function alignBoundaryForward(messages, idx) {
-	if (idx <= 0 || idx >= messages.length) return idx;
-	const prev = messages[idx - 1];
-	if (prev.role === "assistant" && hasToolCalls(prev)) {
-		const callIds = getToolCallIds(prev);
-		while (idx < messages.length && isToolResultFor(messages[idx], callIds)) idx++;
-	}
-	return idx;
-}
-/**
-* Align a boundary index backward to avoid splitting tool call/result groups.
-* If the boundary falls in the middle of tool results, move it backward to
-* include the assistant message that made the calls.
-*/
-function alignBoundaryBackward(messages, idx) {
-	if (idx <= 0 || idx >= messages.length) return idx;
-	while (idx > 0) {
-		const msg = messages[idx];
-		if (msg.role === "assistant" && hasToolCalls(msg)) break;
-		const prev = messages[idx - 1];
-		if (prev.role === "assistant" && hasToolCalls(prev)) {
-			if (isToolResultFor(msg, getToolCallIds(prev))) {
-				idx--;
-				continue;
-			}
-		}
-		break;
-	}
-	return idx;
-}
-/**
-* Find the compression end boundary using a token budget for the tail.
-* Walks backward from the end, accumulating tokens until budget is reached.
-* Returns the index where compression should stop (everything from this
-* index onward is protected).
-*
-* @param messages All messages
-* @param headEnd Index where the protected head ends (compression starts here)
-* @param tailTokenBudget Maximum tokens to keep in the tail
-* @param minTailMessages Minimum messages to protect in the tail (fallback)
-*/
-function findTailCutByTokens(messages, headEnd, tailTokenBudget = 2e4, minTailMessages = 2) {
-	const n = messages.length;
-	let accumulated = 0;
-	let tokenCut = n;
-	for (let i = n - 1; i >= headEnd; i--) {
-		const msgTokens = estimateMessageTokens([messages[i]]);
-		if (accumulated + msgTokens > tailTokenBudget && tokenCut < n) break;
-		accumulated += msgTokens;
-		tokenCut = i;
-	}
-	const minCut = n - minTailMessages;
-	return alignBoundaryBackward(messages, minCut >= headEnd ? Math.min(tokenCut, minCut) : tokenCut);
-}
-async function findTailCutByTokensWithCounter(messages, headEnd, tokenCounter, tailTokenBudget = 2e4, minTailMessages = 2) {
-	const n = messages.length;
-	let accumulated = 0;
-	let tokenCut = n;
-	for (let i = n - 1; i >= headEnd; i--) {
-		const msgTokens = await tokenCounter([messages[i]]);
-		if (accumulated + msgTokens > tailTokenBudget && tokenCut < n) break;
-		accumulated += msgTokens;
-		tokenCut = i;
-	}
-	const minCut = n - minTailMessages;
-	return alignBoundaryBackward(messages, minCut >= headEnd ? Math.min(tokenCut, minCut) : tokenCut);
-}
-/**
-* Fix orphaned tool call/result pairs after compaction.
-*
-* Two failure modes:
-* 1. Tool result references a call_id whose assistant tool_call was removed
-*    → Remove the orphaned result
-* 2. Assistant has tool_calls whose results were dropped
-*    → Add stub results so the API doesn't error
-*
-* @param messages Messages after compaction
-* @returns Sanitized messages with no orphaned pairs
-*/
-function sanitizeToolPairs(messages) {
-	const survivingCallIds = /* @__PURE__ */ new Set();
-	for (const msg of messages) if (msg.role === "assistant") for (const id of getToolCallIds(msg)) survivingCallIds.add(id);
-	const resultCallIds = /* @__PURE__ */ new Set();
-	for (const msg of messages) for (const part of msg.parts) if ((part.type.startsWith("tool-") || part.type === "dynamic-tool") && "toolCallId" in part && "output" in part) resultCallIds.add(part.toolCallId);
-	const orphanedResults = /* @__PURE__ */ new Set();
-	for (const id of resultCallIds) if (!survivingCallIds.has(id)) orphanedResults.add(id);
-	let result = messages;
-	if (orphanedResults.size > 0) result = result.map((msg) => {
-		const filteredParts = msg.parts.filter((part) => {
-			if ((part.type.startsWith("tool-") || part.type === "dynamic-tool") && "toolCallId" in part && "output" in part) return !orphanedResults.has(part.toolCallId);
-			return true;
-		});
-		if (filteredParts.length !== msg.parts.length) return {
-			...msg,
-			parts: filteredParts
-		};
-		return msg;
-	});
-	const missingResults = /* @__PURE__ */ new Set();
-	for (const id of survivingCallIds) if (!resultCallIds.has(id) && !orphanedResults.has(id)) missingResults.add(id);
-	if (missingResults.size > 0) {
-		const patched = [];
-		for (const msg of result) {
-			patched.push(msg);
-			if (msg.role === "assistant") {
-				for (const id of getToolCallIds(msg)) if (missingResults.has(id)) {
-					const callPart = msg.parts.find((p) => "toolCallId" in p && p.toolCallId === id);
-					patched.push({
-						id: `stub-${id}`,
-						role: "assistant",
-						parts: [{
-							type: "tool-result",
-							toolCallId: id,
-							toolName: callPart?.toolName ?? "unknown",
-							result: "[Result from earlier conversation — see context summary above]"
-						}],
-						createdAt: /* @__PURE__ */ new Date()
-					});
-				}
-			}
-		}
-		result = patched;
-	}
-	return result.filter((msg) => msg.parts.length > 0);
-}
-/**
-* Compute a summary token budget based on the content being compressed.
-* 20% of the compressed content, clamped to 2K-8K tokens.
-*/
-function computeSummaryBudget(messages) {
-	const contentTokens = estimateMessageTokens(messages);
-	const budget = Math.floor(contentTokens * .2);
-	return Math.max(100, budget);
-}
-/**
-* Build a prompt for LLM summarization of compressed messages.
-*
-* @param messages Messages to summarize
-* @param previousSummary Previous summary for iterative updates (or null for first compaction)
-* @param budget Target token count for the summary
-*/
-function buildSummaryPrompt(messages, previousSummary, budget) {
-	const content = messages.map((msg) => {
-		const textParts = msg.parts.filter((p) => p.type === "text").map((p) => p.text).join("\n");
-		const toolParts = msg.parts.filter((p) => p.type.startsWith("tool-") || p.type === "dynamic-tool").map((p) => {
-			const tp = p;
-			const parts = [`[Tool: ${tp.toolName ?? "unknown"}]`];
-			if (tp.input) parts.push(`Input: ${JSON.stringify(tp.input).slice(0, 500)}`);
-			if (tp.output) parts.push(`Output: ${String(tp.output).slice(0, 500)}`);
-			return parts.join("\n");
-		}).join("\n");
-		return `[${msg.role}]\n${textParts}${toolParts ? "\n" + toolParts : ""}`;
-	}).join("\n\n---\n\n");
-	if (previousSummary) return `You are updating a conversation summary. A previous summary exists below. New conversation turns have occurred since then and need to be incorporated.
-
-PREVIOUS SUMMARY:
-${previousSummary}
-
-NEW TURNS TO INCORPORATE:
-${content}
-
-Update the summary. PRESERVE existing information that is still relevant. ADD new information. Remove information only if it is clearly obsolete.
-
-## Topic
-[What the conversation is about]
-
-## Key Points
-[Important information, decisions, and conclusions from the conversation]
-
-## Current State
-[Where things stand now — what has been done, what is in progress]
-
-## Open Items
-[Unresolved questions, pending tasks, or next steps discussed]
-
-Target ~${budget} tokens. Be factual — only include information that was explicitly discussed in the conversation. Do NOT invent file paths, commands, or details that were not mentioned. Write only the summary body.`;
-	return `Create a concise summary of this conversation that preserves the important information for future context.
-
-CONVERSATION TO SUMMARIZE:
-${content}
-
-Use this structure:
-
-## Topic
-[What the conversation is about]
-
-## Key Points
-[Important information, decisions, and conclusions from the conversation]
-
-## Current State
-[Where things stand now — what has been done, what is in progress]
-
-## Open Items
-[Unresolved questions, pending tasks, or next steps discussed]
-
-Target ~${budget} tokens. Be factual — only include information that was explicitly discussed in the conversation. Do NOT invent file paths, commands, or details that were not mentioned. Write only the summary body.`;
-}
-/**
-* Reference compaction implementation.
-*
-* Implements the full hermes-style compaction algorithm:
-* 1. Protect head messages (first N)
-* 2. Protect tail by token budget (walk backward)
-* 3. Align boundaries to tool call groups
-* 4. Summarize middle section with LLM (structured format)
-* 5. Sanitize orphaned tool pairs
-* 6. Iterative summary updates on subsequent compactions
-*
-* @example
-* ```typescript
-* import { createCompactFunction } from "agents/experimental/memory/utils";
-*
-* const session = new Session(provider, {
-*   compaction: {
-*     tokenThreshold: 100000,
-*     fn: createCompactFunction({
-*       summarize: (prompt) => generateText({ model, prompt }).then(r => r.text)
-*     })
-*   }
-* });
-* ```
-*/
-function createCompactFunction(opts) {
-	const protectHead = opts.protectHead ?? 3;
-	const tailTokenBudget = opts.tailTokenBudget ?? 2e4;
-	const minTailMessages = opts.minTailMessages ?? 2;
-	return async (messages, context) => {
-		if (messages.length <= protectHead + minTailMessages) return null;
-		const sessionCounter = context?.tokenCounter;
-		const tailCounter = opts.tokenCounter ?? (sessionCounter ? (msgs) => sessionCounter({
-			messages: msgs,
-			systemPrompt: "",
-			contextBlocks: []
-		}) : void 0);
-		let compressStart = protectHead;
-		compressStart = alignBoundaryForward(messages, compressStart);
-		let compressEnd = tailCounter ? await findTailCutByTokensWithCounter(messages, compressStart, tailCounter, tailTokenBudget, minTailMessages) : findTailCutByTokens(messages, compressStart, tailTokenBudget, minTailMessages);
-		if (compressEnd <= compressStart) return null;
-		const middleMessages = messages.slice(compressStart, compressEnd).filter((m) => !isCompactionMessage(m));
-		if (middleMessages.length === 0) return null;
-		const existingCompaction = messages.find(isCompactionMessage);
-		const prompt = buildSummaryPrompt(middleMessages, existingCompaction ? existingCompaction.parts.filter((p) => p.type === "text").map((p) => p.text).join("\n") : null, computeSummaryBudget(middleMessages));
-		const summary = await opts.summarize(prompt);
-		if (!summary.trim()) return null;
-		return {
-			fromMessageId: middleMessages[0].id,
-			toMessageId: middleMessages[middleMessages.length - 1].id,
-			summary
-		};
-	};
-}
-//#endregion
-export { computeSummaryBudget as a, isCompactionMessage as c, TOKENS_PER_MESSAGE as d, WORDS_TOKEN_MULTIPLIER as f, buildSummaryPrompt as i, sanitizeToolPairs as l, estimateStringTokens as m, alignBoundaryBackward as n, createCompactFunction as o, estimateMessageTokens as p, alignBoundaryForward as r, findTailCutByTokens as s, COMPACTION_PREFIX as t, CHARS_PER_TOKEN as u };
-
-//# sourceMappingURL=compaction-helpers-iiKMr2TQ.js.map