@codeworksh/aikit 0.2.0 → 0.3.0

package/index.mjs

@@ -1,10 +1,12 @@
 import { Filesystem, NamedError, lazy } from "@codeworksh/utils";
-import { Type } from "@sinclair/typebox";
-import { keys, mapValues, pick, pipe } from "remeda";
-import Anthropic from "@anthropic-ai/sdk";
-import { parse } from "partial-json";
+import { Type, TypeGuard } from "@sinclair/typebox";
+import { capitalize, keys, mapValues, pick, pipe } from "remeda";
 import Ajv from "ajv";
 import addFormats from "ajv-formats";
+import { uuidv7 } from "uuidv7";
+import Anthropic from "@anthropic-ai/sdk";
+import { parse } from "partial-json";
+import { transform } from "esbuild";
 //#region src/provider/provider.ts
 let Provider;
 (function(_Provider) {
@@ -239,395 +241,78 @@ let Model;
 	_Model.modelsAreEqual = modelsAreEqual;
 })(Model || (Model = {}));
 //#endregion
-//#region src/message/message.ts
-let Message;
-(function(_Message) {
-	const TextContentSchema = _Message.TextContentSchema = Type.Object({
-		type: Type.Literal("text"),
-		text: Type.String(),
-		textSignature: Type.Optional(Type.String())
-	});
-	const ImageContentSchema = _Message.ImageContentSchema = Type.Object({
-		type: Type.Literal("image"),
-		data: Type.String(),
-		mimeType: Type.String()
-	});
-	const ThinkingContentSchema = _Message.ThinkingContentSchema = Type.Object({
-		type: Type.Literal("thinking"),
-		thinking: Type.String(),
-		thinkingSignature: Type.Optional(Type.String()),
-		redacted: Type.Optional(Type.Boolean())
-	});
-	const ToolCallBaseSchema = _Message.ToolCallBaseSchema = Type.Object({
-		type: Type.Literal("toolCall"),
-		callID: Type.String(),
-		name: Type.String(),
-		arguments: Type.Record(Type.String(), Type.Any()),
-		thoughtSignature: Type.Optional(Type.String()),
-		time: Type.Object({
-			start: Type.Number(),
-			end: Type.Number()
-		})
-	});
-	const ToolSuccessResult = _Message.ToolSuccessResult = Type.Object({
-		content: Type.Array(Type.Union([TextContentSchema, ImageContentSchema])),
-		details: Type.Optional(Type.Any()),
-		isError: Type.Literal(false)
-	});
-	const ToolErrorResult = _Message.ToolErrorResult = Type.Object({
-		content: Type.Array(Type.Union([TextContentSchema, ImageContentSchema])),
-		details: Type.Optional(Type.Any()),
-		isError: Type.Literal(true)
-	});
-	const ToolRunningPartial = _Message.ToolRunningPartial = Type.Object({
-		content: Type.Optional(Type.Array(Type.Union([TextContentSchema, ImageContentSchema]))),
-		details: Type.Optional(Type.Any())
-	});
-	const ToolStatusEnum = _Message.ToolStatusEnum = {
-		pending: "pending",
-		running: "running",
-		completed: "completed",
-		error: "error",
-		skipped: "skipped",
-		aborted: "aborted"
+//#region src/provider/stream.ts
+let Stream;
+(function(_Stream) {
+	const ProtocolProviderNotFoundError = _Stream.ProtocolProviderNotFoundError = NamedError.create("ProtocolProviderNotFoundError", Type.Object({ protocol: Model.KnownProtocolSchema }));
+	const ProtocolMismatchError = _Stream.ProtocolMismatchError = NamedError.create("ProtocolMismatchError", Type.Object({
+		actual: Model.KnownProtocolSchema,
+		expected: Model.KnownProtocolSchema
+	}));
+	const ThinkingLevelEnum = _Stream.ThinkingLevelEnum = {
+		off: "off",
+		minimal: "minimal",
+		low: "low",
+		medium: "medium",
+		high: "high",
+		xhigh: "xhigh"
 	};
-	const ToolRunningSchema = _Message.ToolRunningSchema = Type.Object({
-		status: Type.Literal(ToolStatusEnum.running),
-		partial: Type.Optional(ToolRunningPartial)
-	});
-	const ToolCompletedSchema = _Message.ToolCompletedSchema = Type.Object({
-		status: Type.Literal(ToolStatusEnum.completed),
-		result: ToolSuccessResult
-	});
-	const ToolErrorSchema = _Message.ToolErrorSchema = Type.Object({
-		status: Type.Literal(ToolStatusEnum.error),
-		result: ToolErrorResult
-	});
-	const ToolSkippedSchema = _Message.ToolSkippedSchema = Type.Object({
-		status: Type.Literal(ToolStatusEnum.skipped),
-		result: ToolErrorResult
-	});
-	const ToolAbortedSchema = _Message.ToolAbortedSchema = Type.Object({
-		status: Type.Literal(ToolStatusEnum.aborted),
-		result: ToolErrorResult
-	});
-	const ToolCallPendingPart = Type.Intersect([ToolCallBaseSchema, Type.Object({ status: Type.Literal(ToolStatusEnum.pending) })]);
-	const ToolCallRunningPart = Type.Composite([ToolCallBaseSchema, ToolRunningSchema]);
-	const ToolCallCompletedPart = Type.Composite([ToolCallBaseSchema, ToolCompletedSchema]);
-	const ToolCallErrorPart = Type.Composite([ToolCallBaseSchema, ToolErrorSchema]);
-	const ToolCallSkippedPart = Type.Composite([ToolCallBaseSchema, ToolSkippedSchema]);
-	const ToolCallAbortedPart = Type.Composite([ToolCallBaseSchema, ToolAbortedSchema]);
-	const ToolCallSchema = _Message.ToolCallSchema = Type.Union([
-		ToolCallPendingPart,
-		ToolCallRunningPart,
-		ToolCallCompletedPart,
-		ToolCallErrorPart,
-		ToolCallSkippedPart,
-		ToolCallAbortedPart
+	const ThinkingLevelSchema = _Stream.ThinkingLevelSchema = Type.Union([
+		Type.Literal(ThinkingLevelEnum.off),
+		Type.Literal(ThinkingLevelEnum.minimal),
+		Type.Literal(ThinkingLevelEnum.low),
+		Type.Literal(ThinkingLevelEnum.medium),
+		Type.Literal(ThinkingLevelEnum.high),
+		Type.Literal(ThinkingLevelEnum.xhigh)
 	]);
-	const UsageSchema = _Message.UsageSchema = Type.Object({
-		input: Type.Number(),
-		output: Type.Number(),
-		cacheRead: Type.Number(),
-		cacheWrite: Type.Number(),
-		totalTokens: Type.Number(),
-		cost: Type.Object({
-			input: Type.Number(),
-			output: Type.Number(),
-			cacheRead: Type.Number(),
-			cacheWrite: Type.Number(),
-			total: Type.Number()
-		})
+	const ThinkingBudgetsSchema = _Stream.ThinkingBudgetsSchema = Type.Object({
+		off: Type.Optional(Type.Number()),
+		minimal: Type.Optional(Type.Number()),
+		low: Type.Optional(Type.Number()),
+		medium: Type.Optional(Type.Number()),
+		high: Type.Optional(Type.Number())
 	});
-	const StopReasonSchema = _Message.StopReasonSchema = Type.Union([
-		Type.Literal("stop"),
-		Type.Literal("length"),
-		Type.Literal("toolUse"),
-		Type.Literal("error"),
-		Type.Literal("aborted")
+	const CacheRetentionSchema = _Stream.CacheRetentionSchema = Type.Union([
+		Type.Literal("none"),
+		Type.Literal("short"),
+		Type.Literal("long")
 	]);
-	const UserMessageSchema = _Message.UserMessageSchema = Type.Object({
-		role: Type.Literal("user"),
-		time: Type.Object({ created: Type.Number() }),
-		parts: Type.Array(Type.Union([TextContentSchema, ImageContentSchema]))
-	});
-	const AssistantMessageSchema = _Message.AssistantMessageSchema = Type.Object({
-		role: Type.Literal("assistant"),
-		protocol: Model.KnownProtocolSchema,
-		provider: Provider.Info,
-		model: Type.String(),
-		usage: UsageSchema,
-		stopReason: StopReasonSchema,
-		errorMessage: Type.Optional(Type.String()),
-		time: Type.Object({
-			created: Type.Number(),
-			completed: Type.Number()
-		}),
-		parts: Type.Array(Type.Union([
-			TextContentSchema,
-			ImageContentSchema,
-			ThinkingContentSchema,
-			ToolCallSchema
-		])),
-		responseID: Type.Optional(Type.String())
-	});
-	const MessageSchema = _Message.MessageSchema = Type.Union([UserMessageSchema, AssistantMessageSchema]);
-	const ToolSchema = _Message.ToolSchema = Type.Object({
-		name: Type.String(),
-		description: Type.String(),
-		parameters: Type.Unsafe()
+	const TransportSchema = _Stream.TransportSchema = Type.Union([
+		Type.Literal("sse"),
+		Type.Literal("websocket"),
+		Type.Literal("auto")
+	]);
+	const OptionsSchema = _Stream.OptionsSchema = Type.Object({
+		temperature: Type.Optional(Type.Number()),
+		maxTokens: Type.Optional(Type.Number()),
+		signal: Type.Optional(Type.Unsafe()),
+		apiKey: Type.Optional(Type.String()),
+		transport: Type.Optional(TransportSchema),
+		cacheRetention: Type.Optional(CacheRetentionSchema),
+		sessionId: Type.Optional(Type.String()),
+		onPayload: Type.Optional(Type.Unsafe()),
+		headers: Type.Optional(Type.Record(Type.String(), Type.String())),
+		maxRetryDelayMs: Type.Optional(Type.Number()),
+		metadata: Type.Optional(Type.Record(Type.String(), Type.Unknown()))
 	});
-	function defineTool(tool) {
-		return tool;
-	}
-	_Message.defineTool = defineTool;
-	_Message.ContextSchema = Type.Object({
-		systemPrompt: Type.Optional(Type.String()),
-		messages: Type.Array(MessageSchema),
-		tools: Type.Optional(Type.Array(ToolSchema))
-	});
-	function transformMessages(messages, model, normalizeToolCallId) {
-		const toolCallIDMap = /* @__PURE__ */ new Map();
-		const transformed = [];
-		for (const msg of messages) {
-			if (msg.role === "user") {
-				transformed.push(msg);
-				continue;
-			}
-			const assistantMsg = msg;
-			const isSameModel = assistantMsg.provider.id === model.provider.id && assistantMsg.protocol === model.protocol && assistantMsg.model === model.id;
-			const parts = assistantMsg.parts.flatMap((block) => {
-				if (block.type === "thinking") {
-					if (isSameModel && block.thinkingSignature) return block;
-					if (!block.thinking || block.thinking.trim() === "") return [];
-					if (isSameModel) return block;
-					return {
-						type: "text",
-						text: block.thinking
-					};
-				}
-				if (block.type === "text") {
-					if (isSameModel) return block;
-					return {
-						type: "text",
-						text: block.text
-					};
-				}
-				if (block.type === "toolCall") {
-					const toolCall = block;
-					let normalizedToolCall = toolCall;
-					if (!isSameModel && toolCall.thoughtSignature) {
-						normalizedToolCall = { ...toolCall };
-						delete normalizedToolCall.thoughtSignature;
-					}
-					const normalizedID = toolCallIDMap.get(block.callID);
-					if (normalizedID && normalizedID !== block.callID) normalizedToolCall = {
-						...normalizedToolCall,
-						callID: normalizedID
-					};
-					else if (!isSameModel && normalizeToolCallId) {
-						const nextID = normalizeToolCallId(toolCall.callID, model, assistantMsg);
-						if (nextID !== toolCall.callID) {
-							toolCallIDMap.set(toolCall.callID, nextID);
-							normalizedToolCall = {
-								...normalizedToolCall,
-								callID: nextID
-							};
-						}
-					}
-					return normalizedToolCall;
-				}
-				return block;
-			});
-			transformed.push({
-				...assistantMsg,
-				parts
-			});
-		}
-		return transformed;
-	}
-	_Message.transformMessages = transformMessages;
-})(Message || (Message = {}));
-//#endregion
-//#region src/utils/eventstream.ts
-var EventStream = class {
-	queue = [];
-	waiting = [];
-	done = false;
-	finalResultPromise;
-	resolveFinalResult;
-	constructor(isComplete, extractResult) {
-		this.isComplete = isComplete;
-		this.extractResult = extractResult;
-		this.finalResultPromise = new Promise((resolve) => {
-			this.resolveFinalResult = resolve;
-		});
-	}
-	push(event) {
-		if (this.done) return;
-		if (this.isComplete(event)) {
-			this.done = true;
-			this.resolveFinalResult(this.extractResult(event));
-		}
-		const waiter = this.waiting.shift();
-		if (waiter) waiter({
-			value: event,
-			done: false
-		});
-		else this.queue.push(event);
-	}
-	end(result) {
-		this.done = true;
-		if (result !== void 0) this.resolveFinalResult(result);
-		while (this.waiting.length > 0) this.waiting.shift()({
-			value: void 0,
-			done: true
-		});
-	}
-	async *[Symbol.asyncIterator]() {
-		while (true) if (this.queue.length > 0) yield this.queue.shift();
-		else if (this.done) return;
-		else {
-			const result = await new Promise((resolve) => this.waiting.push(resolve));
-			if (result.done) return;
-			yield result.value;
-		}
-	}
-	result() {
-		return this.finalResultPromise;
-	}
-};
-var AssistantMessageEventStream = class extends EventStream {
-	constructor() {
-		super((event) => event.type === "done" || event.type === "error", (event) => {
-			if (event.type === "done") return event.message;
-			else if (event.type === "error") return event.error;
-			throw new Error("Unexpected event type for final result");
-		});
-	}
-};
-//#endregion
-//#region src/utils/jsonparse.ts
-/**
-* @description Helper function to parse partial jsons during LLM streaming.
-*/
-/**
-* Attempts to parse potentially incomplete JSON during streaming.
-* Always returns a valid object, even if the JSON is incomplete.
-*
-* @param partialJson The partial JSON string from streaming
-* @returns Parsed object or empty object if parsing fails
-*/
-function parseStreamingJson(partialJson) {
-	if (!partialJson || partialJson.trim() === "") return {};
-	try {
-		return JSON.parse(partialJson);
-	} catch {
-		try {
-			return parse(partialJson) ?? {};
-		} catch {
-			return {};
-		}
-	}
-}
-//#endregion
-//#region src/utils/sanitize.ts
-/**
-* Removes unpaired Unicode surrogate characters from a string.
-*
-* Unpaired surrogates (high surrogates 0xD800-0xDBFF without matching low surrogates 0xDC00-0xDFFF,
-* or vice versa) cause JSON serialization errors in many API providers.
-*
-* Valid emoji and other characters outside the Basic Multilingual Plane use properly paired
-* surrogates and will NOT be affected by this function.
-*
-* @param text - The text to sanitize
-* @returns The sanitized text with unpaired surrogates removed
-*
-* @example
-* // Valid emoji (properly paired surrogates) are preserved
-* sanitizeSurrogates("Hello 🙈 World") // => "Hello 🙈 World"
-*
-* // Unpaired high surrogate is removed
-* const unpaired = String.fromCharCode(0xD83D); // high surrogate without low
-* sanitizeSurrogates(`Text ${unpaired} here`) // => "Text  here"
-*/
-function sanitizeSurrogates(text) {
-	return text.replace(/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g, "");
-}
-//#endregion
-//#region src/provider/stream.ts
-let Stream;
-(function(_Stream) {
-	const ProtocolProviderNotFoundError = _Stream.ProtocolProviderNotFoundError = NamedError.create("ProtocolProviderNotFoundError", Type.Object({ protocol: Model.KnownProtocolSchema }));
-	const ProtocolMismatchError = _Stream.ProtocolMismatchError = NamedError.create("ProtocolMismatchError", Type.Object({
-		actual: Model.KnownProtocolSchema,
-		expected: Model.KnownProtocolSchema
-	}));
-	const ThinkingLevelEnum = _Stream.ThinkingLevelEnum = {
-		off: "off",
-		minimal: "minimal",
-		low: "low",
-		medium: "medium",
-		high: "high",
-		xhigh: "xhigh"
-	};
-	const ThinkingLevelSchema = _Stream.ThinkingLevelSchema = Type.Union([
-		Type.Literal(ThinkingLevelEnum.off),
-		Type.Literal(ThinkingLevelEnum.minimal),
-		Type.Literal(ThinkingLevelEnum.low),
-		Type.Literal(ThinkingLevelEnum.medium),
-		Type.Literal(ThinkingLevelEnum.high),
-		Type.Literal(ThinkingLevelEnum.xhigh)
-	]);
-	const ThinkingBudgetsSchema = _Stream.ThinkingBudgetsSchema = Type.Object({
-		off: Type.Optional(Type.Number()),
-		minimal: Type.Optional(Type.Number()),
-		low: Type.Optional(Type.Number()),
-		medium: Type.Optional(Type.Number()),
-		high: Type.Optional(Type.Number())
-	});
-	const CacheRetentionSchema = _Stream.CacheRetentionSchema = Type.Union([
-		Type.Literal("none"),
-		Type.Literal("short"),
-		Type.Literal("long")
-	]);
-	const TransportSchema = _Stream.TransportSchema = Type.Union([
-		Type.Literal("sse"),
-		Type.Literal("websocket"),
-		Type.Literal("auto")
-	]);
-	const OptionsSchema = _Stream.OptionsSchema = Type.Object({
-		temperature: Type.Optional(Type.Number()),
-		maxTokens: Type.Optional(Type.Number()),
-		signal: Type.Optional(Type.Unsafe()),
-		apiKey: Type.Optional(Type.String()),
-		transport: Type.Optional(TransportSchema),
-		cacheRetention: Type.Optional(CacheRetentionSchema),
-		sessionId: Type.Optional(Type.String()),
-		onPayload: Type.Optional(Type.Unsafe()),
-		headers: Type.Optional(Type.Record(Type.String(), Type.String())),
-		maxRetryDelayMs: Type.Optional(Type.Number()),
-		metadata: Type.Optional(Type.Record(Type.String(), Type.Unknown()))
-	});
-	_Stream.SimpleOptionsSchema = Type.Composite([OptionsSchema, Type.Object({
-		reasoning: Type.Optional(ThinkingLevelSchema),
-		thinkingBudgets: Type.Optional(ThinkingBudgetsSchema)
-	})]);
-	function buildBaseOptions(model, options, apiKey) {
-		return {
-			temperature: options?.temperature,
-			maxTokens: options?.maxTokens || Math.min(model.maxTokens, 32e3),
-			signal: options?.signal,
-			apiKey: apiKey || options?.apiKey,
-			transport: options?.transport,
-			cacheRetention: options?.cacheRetention,
-			sessionId: options?.sessionId,
-			headers: options?.headers,
-			onPayload: options?.onPayload,
-			maxRetryDelayMs: options?.maxRetryDelayMs,
-			metadata: options?.metadata
-		};
+	_Stream.SimpleOptionsSchema = Type.Composite([OptionsSchema, Type.Object({
+		reasoning: Type.Optional(ThinkingLevelSchema),
+		thinkingBudgets: Type.Optional(ThinkingBudgetsSchema)
+	})]);
+	function buildBaseOptions(model, options, apiKey) {
+		return {
+			temperature: options?.temperature,
+			maxTokens: options?.maxTokens || Math.min(model.maxTokens, 32e3),
+			signal: options?.signal,
+			apiKey: apiKey || options?.apiKey,
+			transport: options?.transport,
+			cacheRetention: options?.cacheRetention,
+			sessionId: options?.sessionId,
+			headers: options?.headers,
+			onPayload: options?.onPayload,
+			maxRetryDelayMs: options?.maxRetryDelayMs,
+			metadata: options?.metadata
+		};
 	}
 	_Stream.buildBaseOptions = buildBaseOptions;
 	function clampReasoning(effort) {
@@ -722,1099 +407,1439 @@ let Stream;
 	_Stream.clearProtocolProviders = clearProtocolProviders;
 })(Stream || (Stream = {}));
 //#endregion
-//#region src/provider/providers/anthropic/index.ts
-function getEnvApiKey(_provider) {}
-function resolveCacheRetention(cacheRetention) {
-	if (cacheRetention) return cacheRetention;
-	if (typeof process !== "undefined" && process.env.CODEWORK_CACHE_RETENTION === "long") return "long";
-	return "short";
-}
-function getCacheControl(baseUrl, cacheRetention) {
-	const retention = resolveCacheRetention(cacheRetention);
-	if (retention === "none") return { retention };
-	const ttl = retention === "long" && baseUrl.includes("api.anthropic.com") ? "1h" : void 0;
-	return {
-		retention,
-		cacheControl: {
-			type: "ephemeral",
-			...ttl && { ttl }
-		}
-	};
-}
-const claudeCodeVersion = "2.1.2";
-const ccToolLookup = new Map([
-	"Read",
-	"Write",
-	"Edit",
-	"Bash",
-	"Grep",
-	"Glob",
-	"AskUserQuestion",
-	"EnterPlanMode",
-	"ExitPlanMode",
-	"KillShell",
-	"NotebookEdit",
-	"Skill",
-	"Task",
-	"TaskOutput",
-	"TodoWrite",
-	"WebFetch",
-	"WebSearch"
-].map((t) => [t.toLowerCase(), t]));
-const toClaudeCodeName = (name) => ccToolLookup.get(name.toLowerCase()) ?? name;
-const fromClaudeCodeName = (name, tools) => {
-	if (tools && tools.length > 0) {
-		const lowerName = name.toLowerCase();
-		const matchedTool = tools.find((tool) => tool.name.toLowerCase() === lowerName);
-		if (matchedTool) return matchedTool.name;
+//#region src/utils/eventstream.ts
+var EventStream = class {
+	queue = [];
+	waiting = [];
+	done = false;
+	finalResultPromise;
+	resolveFinalResult;
+	constructor(isComplete, extractResult) {
+		this.isComplete = isComplete;
+		this.extractResult = extractResult;
+		this.finalResultPromise = new Promise((resolve) => {
+			this.resolveFinalResult = resolve;
+		});
+	}
+	push(event) {
+		if (this.done) return;
+		if (this.isComplete(event)) {
+			this.done = true;
+			this.resolveFinalResult(this.extractResult(event));
+		}
+		const waiter = this.waiting.shift();
+		if (waiter) waiter({
+			value: event,
+			done: false
+		});
+		else this.queue.push(event);
+	}
+	end(result) {
+		this.done = true;
+		if (result !== void 0) this.resolveFinalResult(result);
+		while (this.waiting.length > 0) this.waiting.shift()({
+			value: void 0,
+			done: true
+		});
+	}
+	async *[Symbol.asyncIterator]() {
+		while (true) if (this.queue.length > 0) yield this.queue.shift();
+		else if (this.done) return;
+		else {
+			const result = await new Promise((resolve) => this.waiting.push(resolve));
+			if (result.done) return;
+			yield result.value;
+		}
+	}
+	result() {
+		return this.finalResultPromise;
 	}
-	return name;
 };
-function convertContentBlocks(content) {
-	if (!content.some((c) => c.type === "image")) return sanitizeSurrogates(content.map((c) => c.text).join("\n"));
-	const blocks = content.map((block) => {
-		if (block.type === "text") return {
-			type: "text",
-			text: sanitizeSurrogates(block.text)
-		};
-		return {
-			type: "image",
-			source: {
-				type: "base64",
-				media_type: block.mimeType,
-				data: block.data
-			}
-		};
-	});
-	if (!blocks.some((b) => b.type === "text")) blocks.unshift({
-		type: "text",
-		text: "(see attached image)"
-	});
-	return blocks;
-}
-function mergeHeaders(...headerSources) {
-	const merged = {};
-	for (const headers of headerSources) if (headers) Object.assign(merged, headers);
-	return merged;
+var AssistantMessageEventStream = class extends EventStream {
+	constructor() {
+		super((event) => event.type === "done" || event.type === "error", (event) => {
+			if (event.type === "done") return event.message;
+			else if (event.type === "error") return event.error;
+			throw new Error("Unexpected event type for final result");
+		});
+	}
+};
+//#endregion
+//#region src/utils/validation.ts
+const ajv = new Ajv({
+	allErrors: true,
+	strict: false,
+	coerceTypes: true
+});
+addFormats(ajv);
+/**
+* Validates an arbitrary value against a TypeBox schema and returns the coerced value.
+*/
+function validateSchema(schema, value, label) {
+	const validate = ajv.compile(schema);
+	const input = structuredClone(value);
+	if (validate(input)) return input;
+	const errors = validate.errors?.map((err) => {
+		return ` - ${err.instancePath ? err.instancePath.substring(1) : err.params?.missingProperty || "root"}: ${err.message}`;
+	}).join("\n") || "Unknown Validation Error";
+	throw new Error([
+		`Validation Failed For ${label}`,
+		`${errors}\n`,
+		"Received Value:",
+		`${JSON.stringify(value, null, 2)}\n`
+	].join("\n"));
 }
-function isOAuthToken(apiKey) {
-	return apiKey.includes("sk-ant-oat");
+/**
+* Validates tool call arguments against the tool's TypeBox schema
+*/
+function validateToolArguments(tool, toolExecution) {
+	return validateSchema(tool.parameters, toolExecution.rawArgs, `Tool "${toolExecution.name}"`);
 }
-function createClient(model, apiKey, interleavedThinking, optionsHeaders) {
-	const betaFeatures = ["fine-grained-tool-streaming-2025-05-14"];
-	if (interleavedThinking) betaFeatures.push("interleaved-thinking-2025-05-14");
-	if (isOAuthToken(apiKey)) {
-		const defaultHeaders = mergeHeaders({
-			accept: "application/json",
-			"anthropic-dangerous-direct-browser-access": "true",
-			"anthropic-beta": `claude-code-20250219,oauth-2025-04-20,${betaFeatures.join(",")}`,
-			"user-agent": `claude-cli/${claudeCodeVersion} (external, cli)`,
-			"x-app": "cli"
-		}, model.headers, optionsHeaders);
+//#endregion
+//#region src/agent/loop.ts
+let Loop;
+(function(_Loop) {
+	function createAgentStream() {
+		return new EventStream((event) => event.type === "agent.end", (event) => event.type === "agent.end" ? event.messages : []);
+	}
+	const AgentContextError = _Loop.AgentContextError = NamedError.create("AgentContextError", Type.Object({ message: Type.String() }));
+	function snapshotAssistantMessage(message) {
+		return structuredClone(message);
+	}
+	function snapshotAssistantPartEvent(message, partIndex) {
+		const snapshot = snapshotAssistantMessage(message);
+		const part = snapshot.parts[partIndex];
+		if (!part) throw new Error(`Assistant message part at index ${partIndex} was not found`);
 		return {
-			client: new Anthropic({
-				apiKey: null,
-				authToken: apiKey,
-				baseURL: model.baseUrl,
-				defaultHeaders,
-				dangerouslyAllowBrowser: true
-			}),
-			isOAuthToken: true
+			message: snapshot,
+			part
 		};
 	}
-	const defaultHeaders = mergeHeaders({
-		accept: "application/json",
-		"anthropic-dangerous-direct-browser-access": "true",
-		"anthropic-beta": betaFeatures.join(",")
-	}, model.headers, optionsHeaders);
-	return {
-		client: new Anthropic({
-			apiKey,
-			baseURL: model.baseUrl,
-			dangerouslyAllowBrowser: true,
-			defaultHeaders
-		}),
-		isOAuthToken: false
-	};
-}
-function normalizeToolCallId(id) {
-	return id.replace(/[^a-zA-Z0-9_-]/g, "_").slice(0, 64);
-}
-function assertReplayableAssistant(message) {
-	let sawToolCall = false;
-	let sawNonTerminalToolCall = false;
-	let sawTerminalToolCall = false;
-	for (const part of message.parts) {
-		if (part.type === "image") throw new Error("Anthropic replay does not support assistant image parts");
-		if (part.type === "toolCall") {
-			sawToolCall = true;
-			if (part.status === "pending" || part.status === "running") sawNonTerminalToolCall = true;
-			else sawTerminalToolCall = true;
-			continue;
-		}
-		if (sawToolCall) throw new Error("Assistant parts after a toolCall are not replayable for Anthropic");
+	async function emitEvent(emit, event) {
+		await emit(event);
 	}
-	if (sawToolCall && message.stopReason !== "toolUse") throw new Error("Assistant message with tool calls must have stopReason 'toolUse'");
-	if (!sawToolCall && message.stopReason === "toolUse") throw new Error("Assistant message with stopReason 'toolUse' must contain at least one toolCall");
-	if (sawTerminalToolCall && sawNonTerminalToolCall) throw new Error("Assistant message cannot mix terminal and non-terminal toolCall states");
-}
-function buildSyntheticToolResult(block) {
-	return {
-		type: "tool_result",
-		tool_use_id: block.callID,
-		content: convertContentBlocks([{
-			type: "text",
-			text: [
-				"<result>",
-				"No Result Provided",
-				"</result>"
-			].join("\n")
-		}]),
-		is_error: true
-	};
-}
-function convertMessages(messages, model, isOAuthToken, cacheControl) {
-	const params = [];
-	const transformedMessages = Message.transformMessages(messages, model, normalizeToolCallId);
-	for (const msg of transformedMessages) {
-		if (msg.role === "user") {
-			const blocks = msg.parts.map((item) => {
-				if (item.type === "text") return {
-					type: "text",
-					text: sanitizeSurrogates(item.text)
-				};
-				return {
-					type: "image",
-					source: {
-						type: "base64",
-						media_type: item.mimeType,
-						data: item.data
-					}
-				};
-			});
-			let filteredBlocks = !model.input.includes("image") ? blocks.filter((b) => b.type !== "image") : blocks;
-			filteredBlocks = filteredBlocks.filter((b) => b.type === "text" ? b.text.trim().length > 0 : true);
-			if (filteredBlocks.length === 0) continue;
-			params.push({
-				role: "user",
-				content: filteredBlocks
+	async function streamAssistantResponse(config, context, emit, streamFn, signal) {
+		let messages = context.messages;
+		if (config.transformContext) messages = await config.transformContext(messages, signal);
+		const llmMessages = await config.convertToLlm(messages);
+		const llmContext = {
+			systemPrompt: context.systemPrompt,
+			messages: llmMessages,
+			tools: context.tools
+		};
+		const streamFunction = streamFn || Stream.streamSimple;
+		const resolvedApiKey = (config.getApiKey ? await config.getApiKey(config.model.provider) : void 0) || config.apiKey;
+		const events = await streamFunction(config.model, llmContext, {
+			...config,
+			apiKey: resolvedApiKey,
+			signal
+		});
+		let partialMessage = null;
+		let started = false;
+		const ensureMessageStarted = async (message) => {
+			if (started) return;
+			started = true;
+			await emitEvent(emit, {
+				type: "message.start",
+				message: snapshotAssistantMessage(message)
 			});
-			continue;
-		}
-		if (msg.stopReason === "error" || msg.stopReason === "aborted") continue;
-		assertReplayableAssistant(msg);
-		const assistantBlocks = [];
-		const toolResults = [];
-		for (const block of msg.parts) if (block.type === "text") {
-			if (block.text.trim().length === 0) continue;
-			assistantBlocks.push({
-				type: "text",
-				text: sanitizeSurrogates(block.text)
+		};
+		const emitMessageUpdate = async (message) => {
+			await emitEvent(emit, {
+				type: "message.update",
+				message: snapshotAssistantMessage(message)
 			});
-		} else if (block.type === "thinking") {
-			if (block.thinking.trim().length === 0) continue;
-			if (!block.thinkingSignature || block.thinkingSignature.trim().length === 0) assistantBlocks.push({
-				type: "text",
-				text: sanitizeSurrogates(block.thinking)
+		};
+		const emitPartStart = async (message, partIndex) => {
+			await emitEvent(emit, {
+				type: "message.part.start",
+				partIndex,
+				...snapshotAssistantPartEvent(message, partIndex)
 			});
-			else assistantBlocks.push({
-				type: "thinking",
-				thinking: sanitizeSurrogates(block.thinking),
-				signature: block.thinkingSignature
-			});
-		} else if (block.type === "toolCall") {
-			assistantBlocks.push({
-				type: "tool_use",
-				id: block.callID,
-				name: isOAuthToken ? toClaudeCodeName(block.name) : block.name,
-				input: block.arguments ?? {}
+		};
+		const emitPartUpdate = async (message, partIndex) => {
+			await emitEvent(emit, {
+				type: "message.part.update",
+				partIndex,
+				...snapshotAssistantPartEvent(message, partIndex),
+				source: "llm"
 			});
-			if (block.status === "pending" || block.status === "running") toolResults.push(buildSyntheticToolResult(block));
-			else toolResults.push({
-				type: "tool_result",
-				tool_use_id: block.callID,
-				content: convertContentBlocks(block.result.content),
-				is_error: block.result.isError
+		};
+		const emitPartEnd = async (message, partIndex) => {
+			await emitEvent(emit, {
+				type: "message.part.end",
+				partIndex,
+				...snapshotAssistantPartEvent(message, partIndex)
 			});
+		};
+		for await (const event of events) switch (event.type) {
+			case "start":
+				partialMessage = event.partial;
+				await ensureMessageStarted(partialMessage);
+				break;
+			case "text.start":
+			case "thinking.start":
+			case "toolcall.start":
+				partialMessage = event.partial;
+				await ensureMessageStarted(partialMessage);
+				await emitPartStart(partialMessage, event.partIndex);
+				break;
+			case "text.delta":
+			case "thinking.delta":
+			case "toolcall.delta":
+				partialMessage = event.partial;
+				await ensureMessageStarted(partialMessage);
+				await emitPartUpdate(partialMessage, event.partIndex);
+				break;
+			case "text.end":
+			case "thinking.end":
+			case "toolcall.end":
+				partialMessage = event.partial;
+				await ensureMessageStarted(partialMessage);
+				await emitPartEnd(partialMessage, event.partIndex);
+				await emitMessageUpdate(partialMessage);
+				break;
+			case "done":
+				await ensureMessageStarted(event.message);
+				await emitEvent(emit, {
+					type: "message.end",
+					message: snapshotAssistantMessage(event.message)
+				});
+				return event.message;
+			case "error":
+				await ensureMessageStarted(event.error);
+				await emitEvent(emit, {
+					type: "message.end",
+					message: snapshotAssistantMessage(event.error)
+				});
+				return event.error;
 		}
-		if (assistantBlocks.length > 0) params.push({
-			role: "assistant",
-			content: assistantBlocks
-		});
-		if (toolResults.length > 0) params.push({
-			role: "user",
-			content: toolResults
+		const finalMessage = await events.result();
+		await ensureMessageStarted(finalMessage);
+		await emitEvent(emit, {
+			type: "message.end",
+			message: snapshotAssistantMessage(finalMessage)
 		});
+		return finalMessage;
 	}
-	if (cacheControl && params.length > 0) {
-		const lastMessage = params[params.length - 1];
-		if (lastMessage.role === "user") {
-			if (Array.isArray(lastMessage.content)) {
-				const lastBlock = lastMessage.content[lastMessage.content.length - 1];
-				if (lastBlock && (lastBlock.type === "text" || lastBlock.type === "image" || lastBlock.type === "tool_result")) lastBlock.cache_control = cacheControl;
-			} else if (typeof lastMessage.content === "string") lastMessage.content = [{
-				type: "text",
-				text: lastMessage.content,
-				cache_control: cacheControl
-			}];
-		}
-	}
-	return params;
-}
-function convertTools(tools, isOAuthToken) {
-	if (!tools) return [];
-	return tools.map((tool) => {
-		const jsonSchema = tool.parameters;
-		return {
-			name: isOAuthToken ? toClaudeCodeName(tool.name) : tool.name,
-			description: tool.description,
-			input_schema: {
-				type: "object",
-				properties: jsonSchema.properties || {},
-				required: jsonSchema.required || []
-			}
-		};
-	});
-}
-function mapStopReason(reason) {
-	switch (reason) {
-		case "end_turn": return "stop";
-		case "max_tokens": return "length";
-		case "tool_use": return "toolUse";
-		case "pause_turn":
-		case "stop_sequence": return "stop";
-		case "refusal":
-		case "sensitive": return "error";
-		default: throw new Error("Unhandled Anthropic stop reason");
-	}
-}
-function buildParams(model, context, isOAuthToken, options) {
-	const { cacheControl } = getCacheControl(model.baseUrl, options?.cacheRetention);
-	const params = {
-		model: model.id,
-		messages: convertMessages(context.messages, model, isOAuthToken, cacheControl),
-		max_tokens: options?.maxTokens || model.maxTokens / 3 | 0,
-		stream: true
-	};
-	if (isOAuthToken) {
-		params.system = [{
-			type: "text",
-			text: "You are Claude Code, Anthropic's official CLI for Claude.",
-			...cacheControl ? { cache_control: cacheControl } : {}
-		}];
-		if (context.systemPrompt) params.system.push({
-			type: "text",
-			text: sanitizeSurrogates(context.systemPrompt),
-			...cacheControl ? { cache_control: cacheControl } : {}
-		});
-	} else if (context.systemPrompt) params.system = [{
-		type: "text",
-		text: sanitizeSurrogates(context.systemPrompt),
-		...cacheControl ? { cache_control: cacheControl } : {}
-	}];
-	if (options?.temperature !== void 0 && !options?.thinkingEnabled) params.temperature = options.temperature;
-	if (context.tools) params.tools = convertTools(context.tools, isOAuthToken);
-	if (options?.thinkingEnabled && model.reasoning) params.thinking = {
-		type: "enabled",
-		budget_tokens: options.thinkingBudgetTokens || 1024
-	};
-	if (options?.metadata) {
-		const userId = options.metadata.user_id;
-		if (typeof userId === "string") params.metadata = { user_id: userId };
+	async function executeToolCalls(config, currentContext, message, toolCalls, emit, signal) {
+		if (config.toolExecution === "sequential") return executeToolCallsSequential(config, currentContext, message, toolCalls, emit, signal);
+		return executeToolCallsParallel(config, currentContext, message, toolCalls, emit, signal);
 	}
-	if (options?.toolChoice) params.tool_choice = typeof options.toolChoice === "string" ? { type: options.toolChoice } : options.toolChoice;
-	return params;
-}
-const streamAnthropic = (model, context, options) => {
-	const stream = new AssistantMessageEventStream();
-	(async () => {
-		const output = {
-			role: "assistant",
-			parts: [],
-			protocol: model.protocol,
-			provider: model.provider,
-			model: model.id,
-			usage: {
-				input: 0,
-				output: 0,
-				cacheRead: 0,
-				cacheWrite: 0,
-				totalTokens: 0,
-				cost: {
-					input: 0,
-					output: 0,
-					cacheRead: 0,
-					cacheWrite: 0,
-					total: 0
-				}
-			},
-			stopReason: "stop",
-			time: {
-				created: Date.now(),
-				completed: Date.now()
-			}
-		};
-		try {
-			let client;
-			let isOAuthToken;
-			if (options?.client) {
-				client = options.client;
-				isOAuthToken = false;
+	async function executeToolCallsSequential(config, currentContext, message, toolCalls, emit, signal) {
+		for (const toolCall of toolCalls) {
+			const toolCallInFlight = {
+				callID: toolCall.callID,
+				name: toolCall.name,
+				rawArgs: toolCall.arguments
+			};
+			await emitEvent(emit, {
+				type: "tool.execution.start",
+				...toolCallInFlight
+			});
+			const prepared = await prepareToolCall(config, currentContext, message, toolCallInFlight, signal);
+			if (prepared.error) {
+				const error = {
+					status: "error",
+					result: {
+						content: [{
+							type: "text",
+							text: prepared.error.message
+						}],
+						details: prepared.error.details,
+						isError: true
+					}
+				};
+				await emitToolCallTerminalResult(toolCall, prepared.runnable, message, emit, error);
 			} else {
-				const apiKey = options?.apiKey ?? getEnvApiKey(model.provider);
-				if (!apiKey) throw new Error(`No API key for provider: ${model.provider.id}`);
-				const created = createClient(model, apiKey, options?.interleavedThinking ?? true, options?.headers);
-				client = created.client;
-				isOAuthToken = created.isOAuthToken;
+				const runnable = {
+					toolCall,
+					runnable: prepared.runnable,
+					tool: prepared.tool
+				};
+				const executed = await executeRunnableToolCall(runnable, message, emit, signal);
+				if (executed.error) {
+					const error = {
+						status: "error",
+						result: {
+							content: [{
+								type: "text",
+								text: executed.error.message
+							}],
+							details: executed.error.details,
+							isError: true
+						}
+					};
+					await emitToolCallTerminalResult(runnable.toolCall, runnable.runnable, message, emit, error);
+				} else await finalizeExecutedToolCall(config, currentContext, runnable.toolCall, runnable.runnable, message, emit, executed.result);
 			}
-			let params = buildParams(model, context, isOAuthToken, options);
-			const nextParams = await options?.onPayload?.(params, model);
-			if (nextParams !== void 0) params = nextParams;
-			const anthropicStream = client.messages.stream({
-				...params,
-				stream: true
-			}, { signal: options?.signal });
-			stream.push({
-				type: "start",
-				partial: output
+		}
+	}
+	async function executeToolCallsParallel(config, currentContext, message, toolCalls, emit, signal) {
+		const runnables = [];
+		for (const toolCall of toolCalls) {
+			const toolCallInFlight = {
+				callID: toolCall.callID,
+				name: toolCall.name,
+				rawArgs: toolCall.arguments
+			};
+			await emitEvent(emit, {
+				type: "tool.execution.start",
+				...toolCallInFlight
 			});
-			const blocks = output.parts;
-			for await (const event of anthropicStream) if (event.type === "message_start") {
-				output.responseID = event.message.id;
-				output.usage.input = event.message.usage.input_tokens || 0;
-				output.usage.output = event.message.usage.output_tokens || 0;
-				output.usage.cacheRead = event.message.usage.cache_read_input_tokens || 0;
-				output.usage.cacheWrite = event.message.usage.cache_creation_input_tokens || 0;
-				output.usage.totalTokens = output.usage.input + output.usage.output + output.usage.cacheRead + output.usage.cacheWrite;
-				Model.calculateCost(model, output.usage);
-			} else if (event.type === "content_block_start") {
-				if (event.content_block.type === "text") {
-					const block = {
-						type: "text",
-						text: "",
-						index: event.index
-					};
-					output.parts.push(block);
-					stream.push({
-						type: "text.start",
-						partIndex: output.parts.length - 1,
-						partial: output
+			const prepared = await prepareToolCall(config, currentContext, message, toolCallInFlight, signal);
+			if (prepared.error) {
+				const error = {
+					status: "error",
+					result: {
+						content: [{
+							type: "text",
+							text: prepared.error.message
+						}],
+						details: prepared.error.details,
+						isError: true
+					}
+				};
+				await emitToolCallTerminalResult(toolCall, prepared.runnable, message, emit, error);
+			} else runnables.push({
+				toolCall,
+				runnable: prepared.runnable,
+				tool: prepared.tool
+			});
+		}
+		const runningExecutions = runnables.map((runnable) => ({
+			runnable,
+			execution: executeRunnableToolCall(runnable, message, emit, signal)
+		}));
+		for (const running of runningExecutions) {
+			const executed = await running.execution;
+			const { runnable } = running;
+			if (executed.error) {
+				const error = {
+					status: "error",
+					result: {
+						content: [{
+							type: "text",
+							text: executed.error.message
+						}],
+						details: executed.error.details,
+						isError: true
+					}
+				};
+				await emitToolCallTerminalResult(runnable.toolCall, runnable.runnable, message, emit, error);
+			} else await finalizeExecutedToolCall(config, currentContext, runnable.toolCall, runnable.runnable, message, emit, executed.result);
+		}
+	}
+	async function prepareToolCall(config, currentContext, assistantMessage, toolCallInFlight, signal) {
+		const tool = currentContext.tools?.find((t) => t.name === toolCallInFlight.name);
+		if (!tool) return {
+			error: {
+				kind: "error",
+				message: `Tool ${toolCallInFlight.name} Not Found`
+			},
+			runnable: toolCallInFlight
+		};
+		try {
+			toolCallInFlight.args = validateToolArguments(tool, toolCallInFlight);
+			if (config.beforeToolExecution) {
+				const beforeResult = await config.beforeToolExecution({
+					context: currentContext,
+					assistantMessage,
+					toolCall: toolCallInFlight
+				}, signal);
+				if (beforeResult?.block) return {
+					error: {
+						kind: "blocked",
+						message: beforeResult?.reason || "Tool Execution was Blocked",
+						details: beforeResult?.details
+					},
+					runnable: toolCallInFlight
+				};
+			}
+			return {
+				runnable: toolCallInFlight,
+				tool
+			};
+		} catch (err) {
+			return {
+				error: {
+					kind: "error",
+					message: err instanceof Error ? err.message : String(err)
+				},
+				runnable: toolCallInFlight
+			};
+		}
+	}
+	async function executeRunnableToolCall(toolCallRunnable, message, emit, signal) {
+		const { toolCall, runnable, tool } = toolCallRunnable;
+		const { partIndex, ...pendingPart } = toolCall;
+		try {
+			return { result: await tool.execute(runnable.callID, runnable.args, signal, async (result) => {
+				const runningResult = {
+					status: "running",
+					partial: result.partial
+				};
+				await emitEvent(emit, {
+					type: "tool.execution.update",
+					...runnable,
+					...runningResult
+				});
+				const runningPart = {
+					...pendingPart,
+					...runningResult
+				};
+				message.parts[partIndex] = runningPart;
+				await emitEvent(emit, {
+					type: "message.part.update",
+					message,
+					partIndex,
+					part: runningPart,
+					source: "tool"
+				});
+			}) };
+		} catch (err) {
+			return { error: { message: err instanceof Error ? err.message : String(err) } };
+		}
+	}
+	async function emitToolCallTerminalResult(toolCall, runnable, message, emit, result) {
+		const { partIndex, ...pendingPart } = toolCall;
+		const { time } = pendingPart;
+		await emitEvent(emit, {
+			type: "tool.execution.end",
+			...runnable,
+			...result
+		});
+		const part = {
+			...pendingPart,
+			...result,
+			time: {
+				start: time.start,
+				end: Date.now()
+			}
+		};
+		message.parts[partIndex] = part;
+		await emitEvent(emit, {
+			type: "message.part.start",
+			message,
+			partIndex,
+			part
+		});
+		await emitEvent(emit, {
+			type: "message.part.end",
+			message,
+			partIndex,
+			part
+		});
+		await emitEvent(emit, {
+			type: "message.update",
+			message
+		});
+	}
+	async function finalizeExecutedToolCall(config, currentContext, toolCall, runnable, message, emit, result, signal) {
+		if (config.afterToolExecution) {
+			const afterResult = await config.afterToolExecution({
+				context: currentContext,
+				assistantMessage: message,
+				toolCall: runnable,
+				result
+			}, signal);
+			if (afterResult) {
+				await emitToolCallTerminalResult(toolCall, runnable, message, emit, afterResult);
+				return;
+			}
+		}
+		await emitToolCallTerminalResult(toolCall, runnable, message, emit, result);
+	}
+	/**
+	* Main core loop shared by run and runContinue.
+	*/
+	async function runLoop(config, currentContext, newMessages, emit, streamFn, signal) {
+		let firstTurn = true;
+		let pendingMessages = await config.getSteeringMessages?.() || [];
+		while (true) {
+			let hasMoreToolCalls = true;
+			while (hasMoreToolCalls || pendingMessages.length > 0) {
+				if (!firstTurn) await emitEvent(emit, { type: "turn.start" });
+				else firstTurn = false;
+				if (pendingMessages.length > 0) {
+					for (const message of pendingMessages) {
+						await emitEvent(emit, {
+							type: "message.start",
+							message
+						});
+						for (const [partIndex, part] of message.parts.entries()) {
+							await emitEvent(emit, {
+								type: "message.part.start",
+								message,
+								partIndex,
+								part
+							});
+							await emitEvent(emit, {
+								type: "message.part.end",
+								message,
+								partIndex,
+								part
+							});
+							await emitEvent(emit, {
+								type: "message.update",
+								message
+							});
+						}
+						await emitEvent(emit, {
+							type: "message.end",
+							message
+						});
+						currentContext.messages.push(message);
+						newMessages.push(message);
+					}
+					pendingMessages = [];
+				}
+				const message = await streamAssistantResponse(config, currentContext, emit, streamFn, signal);
+				if (message.stopReason === "error" || message.stopReason === "aborted") {
+					currentContext.messages.push(message);
+					newMessages.push(message);
+					await emitEvent(emit, {
+						type: "turn.end",
+						message
 					});
-				} else if (event.content_block.type === "thinking") {
-					const block = {
-						type: "thinking",
-						thinking: "",
-						thinkingSignature: "",
-						index: event.index
-					};
-					output.parts.push(block);
-					stream.push({
-						type: "thinking.start",
-						partIndex: output.parts.length - 1,
-						partial: output
-					});
-				} else if (event.content_block.type === "redacted_thinking") {
-					const block = {
-						type: "thinking",
-						thinking: "[Reasoning redacted]",
-						thinkingSignature: event.content_block.data,
-						redacted: true,
-						index: event.index
-					};
-					output.parts.push(block);
-					stream.push({
-						type: "thinking.start",
-						partIndex: output.parts.length - 1,
-						partial: output
-					});
-				} else if (event.content_block.type === "tool_use") {
-					const block = {
-						type: "toolCall",
-						callID: event.content_block.id,
-						name: isOAuthToken ? fromClaudeCodeName(event.content_block.name, context.tools) : event.content_block.name,
-						arguments: event.content_block.input ?? {},
-						partialJson: "",
-						status: "pending",
-						time: {
-							start: Date.now(),
-							end: Date.now()
-						},
-						index: event.index
-					};
-					output.parts.push(block);
-					stream.push({
-						type: "toolcall.start",
-						partIndex: output.parts.length - 1,
-						partial: output
+					await emitEvent(emit, {
+						type: "agent.end",
+						messages: newMessages
 					});
+					return;
 				}
-			} else if (event.type === "content_block_delta") {
-				const partIndex = blocks.findIndex((b) => b.index === event.index);
-				const block = blocks[partIndex];
-				if (!block) continue;
-				if (event.delta.type === "text_delta" && block.type === "text") {
-					block.text += event.delta.text;
-					stream.push({
-						type: "text.delta",
-						partIndex,
-						delta: event.delta.text,
-						partial: output
-					});
-				} else if (event.delta.type === "thinking_delta" && block.type === "thinking") {
-					block.thinking += event.delta.thinking;
-					stream.push({
-						type: "thinking.delta",
-						partIndex,
-						delta: event.delta.thinking,
-						partial: output
-					});
-				} else if (event.delta.type === "input_json_delta" && block.type === "toolCall") {
-					block.partialJson += event.delta.partial_json;
-					block.arguments = parseStreamingJson(block.partialJson);
-					stream.push({
-						type: "toolcall.delta",
-						partIndex,
-						delta: event.delta.partial_json,
-						partial: output
-					});
-				} else if (event.delta.type === "signature_delta" && block.type === "thinking") {
-					block.thinkingSignature = block.thinkingSignature || "";
-					block.thinkingSignature += event.delta.signature;
+				const toolCalls = message.parts.map((part, index) => ({
+					...part,
+					partIndex: index
+				})).filter((part) => part.type === "toolCall" && part.status === "pending");
+				hasMoreToolCalls = toolCalls.length > 0;
+				if (hasMoreToolCalls) await executeToolCalls(config, currentContext, message, toolCalls, emit, signal);
+				currentContext.messages.push(message);
+				newMessages.push(message);
+				await emitEvent(emit, {
+					type: "turn.end",
+					message
+				});
+				pendingMessages = await config.getSteeringMessages?.() || [];
+			}
+			const followUpMessages = await config.getFollowUpMessages?.() || [];
+			if (followUpMessages.length > 0) {
+				pendingMessages = followUpMessages;
+				continue;
+			}
+			break;
+		}
+		await emitEvent(emit, {
+			type: "agent.end",
+			messages: newMessages
+		});
+	}
+	async function runAgentLoop(config, context, prompts, emit, streamFn, signal) {
+		/**
+		* maintain 2 arrays to represent state, `context` the actual full state sent to the LLM,
+		* `newMessages` for intermediate current loop state.
+		* think of newMessages as subset of context.messages for the running current loop.
+		* they do move at the same speed staring with initial user prompts.
+		* */
+		const newMessages = [...prompts];
+		const currentContext = {
+			...context,
+			messages: [...context.messages, ...prompts]
+		};
+		await emitEvent(emit, { type: "agent.start" });
+		await emitEvent(emit, { type: "turn.start" });
+		for (const prompt of prompts) {
+			await emitEvent(emit, {
+				type: "message.start",
+				message: prompt
+			});
+			for (const [partIndex, part] of prompt.parts.entries()) {
+				await emitEvent(emit, {
+					type: "message.part.start",
+					message: prompt,
+					partIndex,
+					part
+				});
+				await emitEvent(emit, {
+					type: "message.part.end",
+					message: prompt,
+					partIndex,
+					part
+				});
+			}
+			await emitEvent(emit, {
+				type: "message.end",
+				message: prompt
+			});
+		}
+		await runLoop(config, currentContext, newMessages, emit, streamFn, signal);
+		return newMessages;
+	}
+	_Loop.runAgentLoop = runAgentLoop;
+	async function runAgentLoopContinue(config, context, emit, streamFn, signal) {
+		if (context.messages.length === 0) throw new AgentContextError({ message: "connot continue: no messages in context" });
+		if (context.messages[context.messages.length - 1]?.role === "assistant") throw new AgentContextError({ message: "cannot continue from message role: assistant" });
+		const newMessages = [];
+		const currentContext = { ...context };
+		await emitEvent(emit, { type: "agent.start" });
+		await emitEvent(emit, { type: "turn.start" });
+		await runLoop(config, currentContext, newMessages, emit, streamFn, signal);
+		return newMessages;
+	}
+	_Loop.runAgentLoopContinue = runAgentLoopContinue;
+	function run(config, context, prompts, streamFn, signal) {
+		const stream = createAgentStream();
+		runAgentLoop(config, context, prompts, async (event) => {
+			stream.push(event);
+		}, streamFn, signal).then((messages) => {
+			stream.end(messages);
+		});
+		return stream;
+	}
+	_Loop.run = run;
+	function runContinue(config, context, streamFn, signal) {
+		const stream = createAgentStream();
+		runAgentLoopContinue(config, context, async (event) => {
+			stream.push(event);
+		}, streamFn, signal).then((messages) => {
+			stream.end(messages);
+		});
+		return stream;
+	}
+	_Loop.runContinue = runContinue;
+})(Loop || (Loop = {}));
+//#endregion
+//#region src/agent.ts
+const agent = {
+	loop: Loop.run,
+	loopContinue: Loop.runContinue
+};
+//#endregion
+//#region src/message/message.ts
+let Message;
+(function(_Message) {
+	const TextContentSchema = _Message.TextContentSchema = Type.Object({
+		type: Type.Literal("text"),
+		text: Type.String(),
+		textSignature: Type.Optional(Type.String())
+	});
+	const ImageContentSchema = _Message.ImageContentSchema = Type.Object({
+		type: Type.Literal("image"),
+		data: Type.String(),
+		mimeType: Type.String()
+	});
+	const ThinkingContentSchema = _Message.ThinkingContentSchema = Type.Object({
+		type: Type.Literal("thinking"),
+		thinking: Type.String(),
+		thinkingSignature: Type.Optional(Type.String()),
+		redacted: Type.Optional(Type.Boolean())
+	});
+	const ToolCallBaseSchema = _Message.ToolCallBaseSchema = Type.Object({
+		type: Type.Literal("toolCall"),
+		callID: Type.String(),
+		name: Type.String(),
+		arguments: Type.Record(Type.String(), Type.Any()),
+		thoughtSignature: Type.Optional(Type.String()),
+		time: Type.Object({
+			start: Type.Number(),
+			end: Type.Number()
+		})
+	});
+	const ToolSuccessResult = _Message.ToolSuccessResult = Type.Object({
+		content: Type.Array(Type.Union([TextContentSchema, ImageContentSchema])),
+		details: Type.Optional(Type.Any()),
+		isError: Type.Literal(false)
+	});
+	const ToolErrorResult = _Message.ToolErrorResult = Type.Object({
+		content: Type.Array(Type.Union([TextContentSchema, ImageContentSchema])),
+		details: Type.Optional(Type.Any()),
+		isError: Type.Literal(true)
+	});
+	const ToolRunningPartial = _Message.ToolRunningPartial = Type.Object({
+		content: Type.Optional(Type.Array(Type.Union([TextContentSchema, ImageContentSchema]))),
+		details: Type.Optional(Type.Any())
+	});
+	const ToolStatusEnum = _Message.ToolStatusEnum = {
+		pending: "pending",
+		running: "running",
+		completed: "completed",
+		error: "error",
+		skipped: "skipped",
+		aborted: "aborted"
+	};
+	const ToolRunningSchema = _Message.ToolRunningSchema = Type.Object({
+		status: Type.Literal(ToolStatusEnum.running),
+		partial: Type.Optional(ToolRunningPartial)
+	});
+	const ToolCompletedSchema = _Message.ToolCompletedSchema = Type.Object({
+		status: Type.Literal(ToolStatusEnum.completed),
+		result: ToolSuccessResult
+	});
+	const ToolErrorSchema = _Message.ToolErrorSchema = Type.Object({
+		status: Type.Literal(ToolStatusEnum.error),
+		result: ToolErrorResult
+	});
+	const ToolSkippedSchema = _Message.ToolSkippedSchema = Type.Object({
+		status: Type.Literal(ToolStatusEnum.skipped),
+		result: ToolErrorResult
+	});
+	const ToolAbortedSchema = _Message.ToolAbortedSchema = Type.Object({
+		status: Type.Literal(ToolStatusEnum.aborted),
+		result: ToolErrorResult
+	});
+	const ToolCallPendingPart = Type.Intersect([ToolCallBaseSchema, Type.Object({ status: Type.Literal(ToolStatusEnum.pending) })]);
+	const ToolCallRunningPart = Type.Composite([ToolCallBaseSchema, ToolRunningSchema]);
+	const ToolCallCompletedPart = Type.Composite([ToolCallBaseSchema, ToolCompletedSchema]);
+	const ToolCallErrorPart = Type.Composite([ToolCallBaseSchema, ToolErrorSchema]);
+	const ToolCallSkippedPart = Type.Composite([ToolCallBaseSchema, ToolSkippedSchema]);
+	const ToolCallAbortedPart = Type.Composite([ToolCallBaseSchema, ToolAbortedSchema]);
+	const ToolCallSchema = _Message.ToolCallSchema = Type.Union([
+		ToolCallPendingPart,
+		ToolCallRunningPart,
+		ToolCallCompletedPart,
+		ToolCallErrorPart,
+		ToolCallSkippedPart,
+		ToolCallAbortedPart
+	]);
+	const UsageSchema = _Message.UsageSchema = Type.Object({
+		input: Type.Number(),
+		output: Type.Number(),
+		cacheRead: Type.Number(),
+		cacheWrite: Type.Number(),
+		totalTokens: Type.Number(),
+		cost: Type.Object({
+			input: Type.Number(),
+			output: Type.Number(),
+			cacheRead: Type.Number(),
+			cacheWrite: Type.Number(),
+			total: Type.Number()
+		})
+	});
+	const StopReasonSchema = _Message.StopReasonSchema = Type.Union([
+		Type.Literal("stop"),
+		Type.Literal("length"),
+		Type.Literal("toolUse"),
+		Type.Literal("error"),
+		Type.Literal("aborted")
+	]);
+	const UserMessageSchema = _Message.UserMessageSchema = Type.Object({
+		messageId: Type.String(),
+		role: Type.Literal("user"),
+		time: Type.Object({ created: Type.Number() }),
+		parts: Type.Array(Type.Union([TextContentSchema, ImageContentSchema]))
+	});
+	const AssistantMessageSchema = _Message.AssistantMessageSchema = Type.Object({
+		role: Type.Literal("assistant"),
+		protocol: Model.KnownProtocolSchema,
+		provider: Provider.Info,
+		model: Type.String(),
+		usage: UsageSchema,
+		stopReason: StopReasonSchema,
+		errorMessage: Type.Optional(Type.String()),
+		time: Type.Object({
+			created: Type.Number(),
+			completed: Type.Number()
+		}),
+		parts: Type.Array(Type.Union([
+			TextContentSchema,
+			ImageContentSchema,
+			ThinkingContentSchema,
+			ToolCallSchema
+		])),
+		responseId: Type.Optional(Type.String()),
+		messageId: Type.String()
+	});
+	const MessageSchema = _Message.MessageSchema = Type.Union([UserMessageSchema, AssistantMessageSchema]);
+	function createMessageId() {
+		return uuidv7();
+	}
+	_Message.createMessageId = createMessageId;
+	function createUserMessage(message) {
+		const { messageId = createMessageId(), ...rest } = message;
+		return {
+			messageId,
+			...rest
+		};
+	}
+	_Message.createUserMessage = createUserMessage;
+	function createAssistantMessage(message) {
+		const { messageId = createMessageId(), ...rest } = message;
+		return {
+			messageId,
+			...rest
+		};
+	}
+	_Message.createAssistantMessage = createAssistantMessage;
+	const ToolSchema = _Message.ToolSchema = Type.Object({
+		name: Type.String(),
+		description: Type.String(),
+		parameters: Type.Unsafe()
+	});
+	function defineTool(tool) {
+		return tool;
+	}
+	_Message.defineTool = defineTool;
+	_Message.ContextSchema = Type.Object({
+		systemPrompt: Type.Optional(Type.String()),
+		messages: Type.Array(MessageSchema),
+		tools: Type.Optional(Type.Array(ToolSchema))
+	});
+	function transformMessages(messages, model, normalizeToolCallId) {
+		const toolCallIDMap = /* @__PURE__ */ new Map();
+		const transformed = [];
+		for (const msg of messages) {
+			if (msg.role === "user") {
+				transformed.push(msg);
+				continue;
+			}
+			const assistantMsg = msg;
+			const isSameModel = assistantMsg.provider.id === model.provider.id && assistantMsg.protocol === model.protocol && assistantMsg.model === model.id;
+			const parts = assistantMsg.parts.flatMap((block) => {
+				if (block.type === "thinking") {
+					if (isSameModel && block.thinkingSignature) return block;
+					if (!block.thinking || block.thinking.trim() === "") return [];
+					if (isSameModel) return block;
+					return {
+						type: "text",
+						text: block.thinking
+					};
 				}
-			} else if (event.type === "content_block_stop") {
-				const partIndex = blocks.findIndex((b) => b.index === event.index);
-				const block = blocks[partIndex];
-				if (block) {
-					delete block.index;
-					if (block.type === "text") stream.push({
-						type: "text.end",
-						partIndex,
-						content: block.text,
-						partial: output
-					});
-					else if (block.type === "thinking") stream.push({
-						type: "thinking.end",
-						partIndex,
-						content: block.thinking,
-						partial: output
-					});
-					else if (block.type === "toolCall") {
-						block.arguments = parseStreamingJson(block.partialJson);
-						delete block.partialJson;
-						stream.push({
-							type: "toolcall.end",
-							partIndex,
-							toolCall: block,
-							partial: output
-						});
+				if (block.type === "text") {
+					if (isSameModel) return block;
+					return {
+						type: "text",
+						text: block.text
+					};
+				}
+				if (block.type === "toolCall") {
+					const toolCall = block;
+					let normalizedToolCall = toolCall;
+					if (!isSameModel && toolCall.thoughtSignature) {
+						normalizedToolCall = { ...toolCall };
+						delete normalizedToolCall.thoughtSignature;
+					}
+					const normalizedID = toolCallIDMap.get(block.callID);
+					if (normalizedID && normalizedID !== block.callID) normalizedToolCall = {
+						...normalizedToolCall,
+						callID: normalizedID
+					};
+					else if (!isSameModel && normalizeToolCallId) {
+						const nextID = normalizeToolCallId(toolCall.callID, model, assistantMsg);
+						if (nextID !== toolCall.callID) {
+							toolCallIDMap.set(toolCall.callID, nextID);
+							normalizedToolCall = {
+								...normalizedToolCall,
+								callID: nextID
+							};
+						}
 					}
+					return normalizedToolCall;
 				}
-			} else if (event.type === "message_delta") {
-				if (event.delta.stop_reason) output.stopReason = mapStopReason(event.delta.stop_reason);
-				if (event.usage.input_tokens != null) output.usage.input = event.usage.input_tokens;
-				if (event.usage.output_tokens != null) output.usage.output = event.usage.output_tokens;
-				if (event.usage.cache_read_input_tokens != null) output.usage.cacheRead = event.usage.cache_read_input_tokens;
-				if (event.usage.cache_creation_input_tokens != null) output.usage.cacheWrite = event.usage.cache_creation_input_tokens;
-				output.usage.totalTokens = output.usage.input + output.usage.output + output.usage.cacheRead + output.usage.cacheWrite;
-				Model.calculateCost(model, output.usage);
-			}
-			if (options?.signal?.aborted) throw new Error("Request was aborted");
-			if (output.stopReason === "aborted" || output.stopReason === "error") throw new Error("An unknown error occurred");
-			output.time.completed = Date.now();
-			stream.push({
-				type: "done",
-				reason: output.stopReason,
-				message: output
+				return block;
 			});
-			stream.end();
-		} catch (error) {
-			for (const block of output.parts) delete block.index;
-			output.time.completed = Date.now();
-			output.stopReason = options?.signal?.aborted ? "aborted" : "error";
-			output.errorMessage = error instanceof Error ? error.message : JSON.stringify(error);
-			stream.push({
-				type: "error",
-				reason: output.stopReason,
-				error: output
+			transformed.push({
+				...assistantMsg,
+				parts
 			});
-			stream.end();
 		}
-	})();
-	return stream;
-};
-const streamSimpleAnthropic = (model, context, options) => {
-	const apiKey = options?.apiKey || getEnvApiKey(model.provider);
-	if (!apiKey) throw new Error(`No API key for provider: ${model.provider.id}`);
-	const base = Stream.buildBaseOptions(model, options, apiKey);
-	if (!options?.reasoning) return streamAnthropic(model, context, {
-		...base,
-		thinkingEnabled: false
-	});
-	const adjusted = Stream.adjustMaxTokensForThinking(base.maxTokens || 0, model.maxTokens, options.reasoning, options.thinkingBudgets);
-	return streamAnthropic(model, context, {
-		...base,
-		maxTokens: adjusted.maxTokens,
-		thinkingEnabled: true,
-		thinkingBudgetTokens: adjusted.thinkingBudget
-	});
-};
-//#endregion
-//#region src/provider/register.ts
-const providerModules = [["providers/anthropic/index.ts", {
-	protocol: Model.KnownProtocolEnum.anthropicMessages,
-	stream: streamAnthropic,
-	streamSimple: streamSimpleAnthropic
-}]];
-for (const [path, provider] of providerModules) Stream.registerProtocolProvider(provider, path);
+		return transformed;
+	}
+	_Message.transformMessages = transformMessages;
+})(Message || (Message = {}));
 //#endregion
-//#region src/utils/validation.ts
+//#region src/utils/jsonparse.ts
 /**
-* @description Validation powered by ajv, TypeBox natively doesn't provide data validation.
+* @description Helper function to parse partial jsons during LLM streaming.
 */
-const ajv = new Ajv({
-	allErrors: true,
-	strict: false,
-	coerceTypes: true
-});
-addFormats(ajv);
 /**
-* Finds a tool by name and validates the tool call arguments against its TypeBox schema
+* Attempts to parse potentially incomplete JSON during streaming.
+* Always returns a valid object, even if the JSON is incomplete.
+*
+* @param partialJson The partial JSON string from streaming
+* @returns Parsed object or empty object if parsing fails
 */
-function validateToolCall(tools, toolExecution) {
-	const tool = tools.find((t) => t.name === toolExecution.name);
-	if (!tool) throw new Error(`Tool "${toolExecution.name}" not found`);
-	return validateToolArguments(tool, toolExecution);
+function parseStreamingJson(partialJson) {
+	if (!partialJson || partialJson.trim() === "") return {};
+	try {
+		return JSON.parse(partialJson);
+	} catch {
+		try {
+			return parse(partialJson) ?? {};
+		} catch {
+			return {};
+		}
+	}
 }
+//#endregion
+//#region src/utils/sanitize.ts
 /**
-* Validates tool call arguments against the tool's TypeBox schema
+* Removes unpaired Unicode surrogate characters from a string.
+*
+* Unpaired surrogates (high surrogates 0xD800-0xDBFF without matching low surrogates 0xDC00-0xDFFF,
+* or vice versa) cause JSON serialization errors in many API providers.
+*
+* Valid emoji and other characters outside the Basic Multilingual Plane use properly paired
+* surrogates and will NOT be affected by this function.
+*
+* @param text - The text to sanitize
+* @returns The sanitized text with unpaired surrogates removed
+*
+* @example
+* // Valid emoji (properly paired surrogates) are preserved
+* sanitizeSurrogates("Hello 🙈 World") // => "Hello 🙈 World"
+*
+* // Unpaired high surrogate is removed
+* const unpaired = String.fromCharCode(0xD83D); // high surrogate without low
+* sanitizeSurrogates(`Text ${unpaired} here`) // => "Text  here"
 */
-function validateToolArguments(tool, toolExecution) {
-	const validate = ajv.compile(tool.parameters);
-	const args = structuredClone(toolExecution.rawArgs);
-	if (validate(args)) return args;
-	const errors = validate.errors?.map((err) => {
-		return ` - ${err.instancePath ? err.instancePath.substring(1) : err.params?.missingProperty || "root"}: ${err.message}`;
-	}).join("\n") || "Unknown Validation Error";
-	throw new Error([
-		`Validation Failed For Tool "${toolExecution.name}"`,
-		`${errors}\n`,
-		"Received Arguments:",
-		`${JSON.stringify(toolExecution.rawArgs, null, 2)}\n`
-	].join("\n"));
+function sanitizeSurrogates(text) {
+	return text.replace(/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g, "");
 }
 //#endregion
-//#region src/agent/loop.ts
-let Loop;
-(function(_Loop) {
-	function createAgentStream() {
-		return new EventStream((event) => event.type === "agent.end", (event) => event.type === "agent.end" ? event.messages : []);
-	}
-	const AgentContextError = _Loop.AgentContextError = NamedError.create("AgentContextError", Type.Object({ message: Type.String() }));
-	function snapshotAssistantMessage(message) {
-		return structuredClone(message);
-	}
-	function snapshotAssistantPartEvent(message, partIndex) {
-		const snapshot = snapshotAssistantMessage(message);
-		const part = snapshot.parts[partIndex];
-		if (!part) throw new Error(`Assistant message part at index ${partIndex} was not found`);
-		return {
-			message: snapshot,
-			part
-		};
-	}
-	async function emitEvent(emit, event) {
-		await emit(event);
+//#region src/provider/providers/anthropic/index.ts
+function getEnvApiKey(_provider) {}
+function resolveCacheRetention(cacheRetention) {
+	if (cacheRetention) return cacheRetention;
+	if (typeof process !== "undefined" && process.env.CODEWORK_CACHE_RETENTION === "long") return "long";
+	return "short";
+}
+function getCacheControl(baseUrl, cacheRetention) {
+	const retention = resolveCacheRetention(cacheRetention);
+	if (retention === "none") return { retention };
+	const ttl = retention === "long" && baseUrl.includes("api.anthropic.com") ? "1h" : void 0;
+	return {
+		retention,
+		cacheControl: {
+			type: "ephemeral",
+			...ttl && { ttl }
+		}
+	};
+}
+const claudeCodeVersion = "2.1.2";
+const ccToolLookup = new Map([
+	"Read",
+	"Write",
+	"Edit",
+	"Bash",
+	"Grep",
+	"Glob",
+	"AskUserQuestion",
+	"EnterPlanMode",
+	"ExitPlanMode",
+	"KillShell",
+	"NotebookEdit",
+	"Skill",
+	"Task",
+	"TaskOutput",
+	"TodoWrite",
+	"WebFetch",
+	"WebSearch"
+].map((t) => [t.toLowerCase(), t]));
+const toClaudeCodeName = (name) => ccToolLookup.get(name.toLowerCase()) ?? name;
+const fromClaudeCodeName = (name, tools) => {
+	if (tools && tools.length > 0) {
+		const lowerName = name.toLowerCase();
+		const matchedTool = tools.find((tool) => tool.name.toLowerCase() === lowerName);
+		if (matchedTool) return matchedTool.name;
 	}
-	async function streamAssistantResponse(config, context, emit, streamFn, signal) {
-		let messages = context.messages;
-		if (config.transformContext) messages = await config.transformContext(messages, signal);
-		const llmMessages = await config.convertToLlm(messages);
-		const llmContext = {
-			systemPrompt: context.systemPrompt,
-			messages: llmMessages,
-			tools: context.tools
-		};
-		const streamFunction = streamFn || Stream.streamSimple;
-		const resolvedApiKey = (config.getApiKey ? await config.getApiKey(config.model.provider) : void 0) || config.apiKey;
-		const events = await streamFunction(config.model, llmContext, {
-			...config,
-			apiKey: resolvedApiKey,
-			signal
-		});
-		let partialMessage = null;
-		let started = false;
-		const ensureMessageStarted = async (message) => {
-			if (started) return;
-			started = true;
-			await emitEvent(emit, {
-				type: "message.start",
-				message: snapshotAssistantMessage(message)
-			});
-		};
-		const emitMessageUpdate = async (message) => {
-			await emitEvent(emit, {
-				type: "message.update",
-				message: snapshotAssistantMessage(message)
-			});
-		};
-		const emitPartStart = async (message, partIndex) => {
-			await emitEvent(emit, {
-				type: "message.part.start",
-				partIndex,
-				...snapshotAssistantPartEvent(message, partIndex)
-			});
+	return name;
+};
+function convertContentBlocks(content) {
+	if (!content.some((c) => c.type === "image")) return sanitizeSurrogates(content.map((c) => c.text).join("\n"));
+	const blocks = content.map((block) => {
+		if (block.type === "text") return {
+			type: "text",
+			text: sanitizeSurrogates(block.text)
 		};
-		const emitPartUpdate = async (message, partIndex) => {
-			await emitEvent(emit, {
-				type: "message.part.update",
-				partIndex,
-				...snapshotAssistantPartEvent(message, partIndex),
-				source: "llm"
-			});
+		return {
+			type: "image",
+			source: {
+				type: "base64",
+				media_type: block.mimeType,
+				data: block.data
+			}
 		};
-		const emitPartEnd = async (message, partIndex) => {
-			await emitEvent(emit, {
-				type: "message.part.end",
-				partIndex,
-				...snapshotAssistantPartEvent(message, partIndex)
-			});
+	});
+	if (!blocks.some((b) => b.type === "text")) blocks.unshift({
+		type: "text",
+		text: "(see attached image)"
+	});
+	return blocks;
+}
+function mergeHeaders(...headerSources) {
+	const merged = {};
+	for (const headers of headerSources) if (headers) Object.assign(merged, headers);
+	return merged;
+}
+function isOAuthToken(apiKey) {
+	return apiKey.includes("sk-ant-oat");
+}
+function createClient(model, apiKey, interleavedThinking, optionsHeaders) {
+	const betaFeatures = ["fine-grained-tool-streaming-2025-05-14"];
+	if (interleavedThinking) betaFeatures.push("interleaved-thinking-2025-05-14");
+	if (isOAuthToken(apiKey)) {
+		const defaultHeaders = mergeHeaders({
+			accept: "application/json",
+			"anthropic-dangerous-direct-browser-access": "true",
+			"anthropic-beta": `claude-code-20250219,oauth-2025-04-20,${betaFeatures.join(",")}`,
+			"user-agent": `claude-cli/${claudeCodeVersion} (external, cli)`,
+			"x-app": "cli"
+		}, model.headers, optionsHeaders);
+		return {
+			client: new Anthropic({
+				apiKey: null,
+				authToken: apiKey,
+				baseURL: model.baseUrl,
+				defaultHeaders,
+				dangerouslyAllowBrowser: true
+			}),
+			isOAuthToken: true
 		};
-		for await (const event of events) switch (event.type) {
-			case "start":
-				partialMessage = event.partial;
-				await ensureMessageStarted(partialMessage);
-				break;
-			case "text.start":
-			case "thinking.start":
-			case "toolcall.start":
-				partialMessage = event.partial;
-				await ensureMessageStarted(partialMessage);
-				await emitPartStart(partialMessage, event.partIndex);
-				break;
-			case "text.delta":
-			case "thinking.delta":
-			case "toolcall.delta":
-				partialMessage = event.partial;
-				await ensureMessageStarted(partialMessage);
-				await emitPartUpdate(partialMessage, event.partIndex);
-				break;
-			case "text.end":
-			case "thinking.end":
-			case "toolcall.end":
-				partialMessage = event.partial;
-				await ensureMessageStarted(partialMessage);
-				await emitPartEnd(partialMessage, event.partIndex);
-				await emitMessageUpdate(partialMessage);
-				break;
-			case "done":
-				await ensureMessageStarted(event.message);
-				await emitEvent(emit, {
-					type: "message.end",
-					message: snapshotAssistantMessage(event.message)
-				});
-				return event.message;
-			case "error":
-				await ensureMessageStarted(event.error);
-				await emitEvent(emit, {
-					type: "message.end",
-					message: snapshotAssistantMessage(event.error)
-				});
-				return event.error;
-		}
-		const finalMessage = await events.result();
-		await ensureMessageStarted(finalMessage);
-		await emitEvent(emit, {
-			type: "message.end",
-			message: snapshotAssistantMessage(finalMessage)
-		});
-		return finalMessage;
 	}
-	async function executeToolCalls(config, currentContext, message, toolCalls, emit, signal) {
-		if (config.toolExecution === "sequential") return executeToolCallsSequential(config, currentContext, message, toolCalls, emit, signal);
-		return executeToolCallsParallel(config, currentContext, message, toolCalls, emit, signal);
-	}
-	async function executeToolCallsSequential(config, currentContext, message, toolCalls, emit, signal) {
-		for (const toolCall of toolCalls) {
-			const toolCallInFlight = {
-				callID: toolCall.callID,
-				name: toolCall.name,
-				rawArgs: toolCall.arguments
-			};
-			await emitEvent(emit, {
-				type: "tool.execution.start",
-				...toolCallInFlight
-			});
-			const prepared = await prepareToolCall(config, currentContext, message, toolCallInFlight, signal);
-			if (prepared.error) {
-				const error = {
-					status: "error",
-					result: {
-						content: [{
-							type: "text",
-							text: prepared.error.message
-						}],
-						details: prepared.error.details,
-						isError: true
-					}
-				};
-				await emitToolCallTerminalResult(toolCall, prepared.runnable, message, emit, error);
-			} else {
-				const runnable = {
-					toolCall,
-					runnable: prepared.runnable,
-					tool: prepared.tool
-				};
-				const executed = await executeRunnableToolCall(runnable, message, emit, signal);
-				if (executed.error) {
-					const error = {
-						status: "error",
-						result: {
-							content: [{
-								type: "text",
-								text: executed.error.message
-							}],
-							details: executed.error.details,
-							isError: true
-						}
-					};
-					await emitToolCallTerminalResult(runnable.toolCall, runnable.runnable, message, emit, error);
-				} else await finalizeExecutedToolCall(config, currentContext, runnable.toolCall, runnable.runnable, message, emit, executed.result);
-			}
+	const defaultHeaders = mergeHeaders({
+		accept: "application/json",
+		"anthropic-dangerous-direct-browser-access": "true",
+		"anthropic-beta": betaFeatures.join(",")
+	}, model.headers, optionsHeaders);
+	return {
+		client: new Anthropic({
+			apiKey,
+			baseURL: model.baseUrl,
+			dangerouslyAllowBrowser: true,
+			defaultHeaders
+		}),
+		isOAuthToken: false
+	};
+}
+function normalizeToolCallId(id) {
+	return id.replace(/[^a-zA-Z0-9_-]/g, "_").slice(0, 64);
+}
+function assertReplayableAssistant(message) {
+	let sawToolCall = false;
+	let sawNonTerminalToolCall = false;
+	let sawTerminalToolCall = false;
+	for (const part of message.parts) {
+		if (part.type === "image") throw new Error("Anthropic replay does not support assistant image parts");
+		if (part.type === "toolCall") {
+			sawToolCall = true;
+			if (part.status === "pending" || part.status === "running") sawNonTerminalToolCall = true;
+			else sawTerminalToolCall = true;
+			continue;
 		}
+		if (sawToolCall) throw new Error("Assistant parts after a toolCall are not replayable for Anthropic");
 	}
-	async function executeToolCallsParallel(config, currentContext, message, toolCalls, emit, signal) {
-		const runnables = [];
-		for (const toolCall of toolCalls) {
-			const toolCallInFlight = {
-				callID: toolCall.callID,
-				name: toolCall.name,
-				rawArgs: toolCall.arguments
-			};
-			await emitEvent(emit, {
-				type: "tool.execution.start",
-				...toolCallInFlight
-			});
-			const prepared = await prepareToolCall(config, currentContext, message, toolCallInFlight, signal);
-			if (prepared.error) {
-				const error = {
-					status: "error",
-					result: {
-						content: [{
-							type: "text",
-							text: prepared.error.message
-						}],
-						details: prepared.error.details,
-						isError: true
+	if (sawToolCall && message.stopReason !== "toolUse") throw new Error("Assistant message with tool calls must have stopReason 'toolUse'");
+	if (!sawToolCall && message.stopReason === "toolUse") throw new Error("Assistant message with stopReason 'toolUse' must contain at least one toolCall");
+	if (sawTerminalToolCall && sawNonTerminalToolCall) throw new Error("Assistant message cannot mix terminal and non-terminal toolCall states");
+}
+function buildSyntheticToolResult(block) {
+	return {
+		type: "tool_result",
+		tool_use_id: block.callID,
+		content: convertContentBlocks([{
+			type: "text",
+			text: [
+				"<result>",
+				"No Result Provided",
+				"</result>"
+			].join("\n")
+		}]),
+		is_error: true
+	};
+}
+function convertMessages(messages, model, isOAuthToken, cacheControl) {
+	const params = [];
+	const transformedMessages = Message.transformMessages(messages, model, normalizeToolCallId);
+	for (const msg of transformedMessages) {
+		if (msg.role === "user") {
+			const blocks = msg.parts.map((item) => {
+				if (item.type === "text") return {
+					type: "text",
+					text: sanitizeSurrogates(item.text)
+				};
+				return {
+					type: "image",
+					source: {
+						type: "base64",
+						media_type: item.mimeType,
+						data: item.data
 					}
 				};
-				await emitToolCallTerminalResult(toolCall, prepared.runnable, message, emit, error);
-			} else runnables.push({
-				toolCall,
-				runnable: prepared.runnable,
-				tool: prepared.tool
 			});
+			let filteredBlocks = !model.input.includes("image") ? blocks.filter((b) => b.type !== "image") : blocks;
+			filteredBlocks = filteredBlocks.filter((b) => b.type === "text" ? b.text.trim().length > 0 : true);
+			if (filteredBlocks.length === 0) continue;
+			params.push({
+				role: "user",
+				content: filteredBlocks
+			});
+			continue;
 		}
-		const runningExecutions = runnables.map((runnable) => ({
-			runnable,
-			execution: executeRunnableToolCall(runnable, message, emit, signal)
-		}));
-		for (const running of runningExecutions) {
-			const executed = await running.execution;
-			const { runnable } = running;
-			if (executed.error) {
-				const error = {
-					status: "error",
-					result: {
-						content: [{
-							type: "text",
-							text: executed.error.message
-						}],
-						details: executed.error.details,
-						isError: true
-					}
-				};
-				await emitToolCallTerminalResult(runnable.toolCall, runnable.runnable, message, emit, error);
-			} else await finalizeExecutedToolCall(config, currentContext, runnable.toolCall, runnable.runnable, message, emit, executed.result);
+		if (msg.stopReason === "error" || msg.stopReason === "aborted") continue;
+		assertReplayableAssistant(msg);
+		const assistantBlocks = [];
+		const toolResults = [];
+		for (const block of msg.parts) if (block.type === "text") {
+			if (block.text.trim().length === 0) continue;
+			assistantBlocks.push({
+				type: "text",
+				text: sanitizeSurrogates(block.text)
+			});
+		} else if (block.type === "thinking") {
+			if (block.thinking.trim().length === 0) continue;
+			if (!block.thinkingSignature || block.thinkingSignature.trim().length === 0) assistantBlocks.push({
+				type: "text",
+				text: sanitizeSurrogates(block.thinking)
+			});
+			else assistantBlocks.push({
+				type: "thinking",
+				thinking: sanitizeSurrogates(block.thinking),
+				signature: block.thinkingSignature
+			});
+		} else if (block.type === "toolCall") {
+			assistantBlocks.push({
+				type: "tool_use",
+				id: block.callID,
+				name: isOAuthToken ? toClaudeCodeName(block.name) : block.name,
+				input: block.arguments ?? {}
+			});
+			if (block.status === "pending" || block.status === "running") toolResults.push(buildSyntheticToolResult(block));
+			else toolResults.push({
+				type: "tool_result",
+				tool_use_id: block.callID,
+				content: convertContentBlocks(block.result.content),
+				is_error: block.result.isError
+			});
 		}
+		if (assistantBlocks.length > 0) params.push({
+			role: "assistant",
+			content: assistantBlocks
+		});
+		if (toolResults.length > 0) params.push({
+			role: "user",
+			content: toolResults
+		});
 	}
-	async function prepareToolCall(config, currentContext, assistantMessage, toolCallInFlight, signal) {
-		const tool = currentContext.tools?.find((t) => t.name === toolCallInFlight.name);
-		if (!tool) return {
-			error: {
-				kind: "error",
-				message: `Tool ${toolCallInFlight.name} Not Found`
-			},
-			runnable: toolCallInFlight
-		};
-		try {
-			toolCallInFlight.args = validateToolArguments(tool, toolCallInFlight);
-			if (config.beforeToolExecution) {
-				const beforeResult = await config.beforeToolExecution({
-					context: currentContext,
-					assistantMessage,
-					toolCall: toolCallInFlight
-				}, signal);
-				if (beforeResult?.block) return {
-					error: {
-						kind: "blocked",
-						message: beforeResult?.reason || "Tool Execution was Blocked",
-						details: beforeResult?.details
-					},
-					runnable: toolCallInFlight
-				};
-			}
-			return {
-				runnable: toolCallInFlight,
-				tool
-			};
-		} catch (err) {
-			return {
-				error: {
-					kind: "error",
-					message: err instanceof Error ? err.message : String(err)
-				},
-				runnable: toolCallInFlight
-			};
+	if (cacheControl && params.length > 0) {
+		const lastMessage = params[params.length - 1];
+		if (lastMessage.role === "user") {
+			if (Array.isArray(lastMessage.content)) {
+				const lastBlock = lastMessage.content[lastMessage.content.length - 1];
+				if (lastBlock && (lastBlock.type === "text" || lastBlock.type === "image" || lastBlock.type === "tool_result")) lastBlock.cache_control = cacheControl;
+			} else if (typeof lastMessage.content === "string") lastMessage.content = [{
+				type: "text",
+				text: lastMessage.content,
+				cache_control: cacheControl
+			}];
 		}
 	}
-	async function executeRunnableToolCall(toolCallRunnable, message, emit, signal) {
-		const { toolCall, runnable, tool } = toolCallRunnable;
-		const { partIndex, ...pendingPart } = toolCall;
-		try {
-			return { result: await tool.execute(runnable.callID, runnable.args, signal, async (result) => {
-				const runningResult = {
-					status: "running",
-					partial: result.partial
-				};
-				await emitEvent(emit, {
-					type: "tool.execution.update",
-					...runnable,
-					...runningResult
-				});
-				const runningPart = {
-					...pendingPart,
-					...runningResult
-				};
-				message.parts[partIndex] = runningPart;
-				await emitEvent(emit, {
-					type: "message.part.update",
-					message,
-					partIndex,
-					part: runningPart,
-					source: "tool"
-				});
-			}) };
-		} catch (err) {
-			return { error: { message: err instanceof Error ? err.message : String(err) } };
-		}
+	return params;
+}
+function convertTools(tools, isOAuthToken) {
+	if (!tools) return [];
+	return tools.map((tool) => {
+		const jsonSchema = tool.parameters;
+		return {
+			name: isOAuthToken ? toClaudeCodeName(tool.name) : tool.name,
+			description: tool.description,
+			input_schema: {
+				type: "object",
+				properties: jsonSchema.properties || {},
+				required: jsonSchema.required || []
+			}
+		};
+	});
+}
+function mapStopReason(reason) {
+	switch (reason) {
+		case "end_turn": return "stop";
+		case "max_tokens": return "length";
+		case "tool_use": return "toolUse";
+		case "pause_turn":
+		case "stop_sequence": return "stop";
+		case "refusal":
+		case "sensitive": return "error";
+		default: throw new Error("Unhandled Anthropic stop reason");
 	}
-	async function emitToolCallTerminalResult(toolCall, runnable, message, emit, result) {
-		const { partIndex, ...pendingPart } = toolCall;
-		const { time } = pendingPart;
-		await emitEvent(emit, {
-			type: "tool.execution.end",
-			...runnable,
-			...result
+}
+function buildParams(model, context, isOAuthToken, options) {
+	const { cacheControl } = getCacheControl(model.baseUrl, options?.cacheRetention);
+	const params = {
+		model: model.id,
+		messages: convertMessages(context.messages, model, isOAuthToken, cacheControl),
+		max_tokens: options?.maxTokens || model.maxTokens / 3 | 0,
+		stream: true
+	};
+	if (isOAuthToken) {
+		params.system = [{
+			type: "text",
+			text: "You are Claude Code, Anthropic's official CLI for Claude.",
+			...cacheControl ? { cache_control: cacheControl } : {}
+		}];
+		if (context.systemPrompt) params.system.push({
+			type: "text",
+			text: sanitizeSurrogates(context.systemPrompt),
+			...cacheControl ? { cache_control: cacheControl } : {}
 		});
-		const part = {
-			...pendingPart,
-			...result,
+	} else if (context.systemPrompt) params.system = [{
+		type: "text",
+		text: sanitizeSurrogates(context.systemPrompt),
+		...cacheControl ? { cache_control: cacheControl } : {}
+	}];
+	if (options?.temperature !== void 0 && !options?.thinkingEnabled) params.temperature = options.temperature;
+	if (context.tools) params.tools = convertTools(context.tools, isOAuthToken);
+	if (options?.thinkingEnabled && model.reasoning) params.thinking = {
+		type: "enabled",
+		budget_tokens: options.thinkingBudgetTokens || 1024
+	};
+	if (options?.metadata) {
+		const userId = options.metadata.user_id;
+		if (typeof userId === "string") params.metadata = { user_id: userId };
+	}
+	if (options?.toolChoice) params.tool_choice = typeof options.toolChoice === "string" ? { type: options.toolChoice } : options.toolChoice;
+	return params;
+}
+const streamAnthropic = (model, context, options) => {
+	const stream = new AssistantMessageEventStream();
+	(async () => {
+		const output = Message.createAssistantMessage({
+			role: "assistant",
+			parts: [],
+			protocol: model.protocol,
+			provider: model.provider,
+			model: model.id,
+			usage: {
+				input: 0,
+				output: 0,
+				cacheRead: 0,
+				cacheWrite: 0,
+				totalTokens: 0,
+				cost: {
+					input: 0,
+					output: 0,
+					cacheRead: 0,
+					cacheWrite: 0,
+					total: 0
+				}
+			},
+			stopReason: "stop",
 			time: {
-				start: time.start,
-				end: Date.now()
+				created: Date.now(),
+				completed: Date.now()
 			}
-		};
-		message.parts[partIndex] = part;
-		await emitEvent(emit, {
-			type: "message.part.start",
-			message,
-			partIndex,
-			part
-		});
-		await emitEvent(emit, {
-			type: "message.part.end",
-			message,
-			partIndex,
-			part
-		});
-		await emitEvent(emit, {
-			type: "message.update",
-			message
 		});
-	}
-	async function finalizeExecutedToolCall(config, currentContext, toolCall, runnable, message, emit, result, signal) {
-		if (config.afterToolExecution) {
-			const afterResult = await config.afterToolExecution({
-				context: currentContext,
-				assistantMessage: message,
-				toolCall: runnable,
-				result
-			}, signal);
-			if (afterResult) {
-				await emitToolCallTerminalResult(toolCall, runnable, message, emit, afterResult);
-				return;
+		try {
+			let client;
+			let isOAuthToken;
+			if (options?.client) {
+				client = options.client;
+				isOAuthToken = false;
+			} else {
+				const apiKey = options?.apiKey ?? getEnvApiKey(model.provider);
+				if (!apiKey) throw new Error(`No API key for provider: ${model.provider.id}`);
+				const created = createClient(model, apiKey, options?.interleavedThinking ?? true, options?.headers);
+				client = created.client;
+				isOAuthToken = created.isOAuthToken;
 			}
-		}
-		await emitToolCallTerminalResult(toolCall, runnable, message, emit, result);
-	}
-	/**
-	* Main core loop shared by run and runContinue.
-	*/
-	async function runLoop(config, currentContext, newMessages, emit, streamFn, signal) {
-		let firstTurn = true;
-		let pendingMessages = await config.getSteeringMessages?.() || [];
-		while (true) {
-			let hasMoreToolCalls = true;
-			while (hasMoreToolCalls || pendingMessages.length > 0) {
-				if (!firstTurn) await emitEvent(emit, { type: "turn.start" });
-				else firstTurn = false;
-				if (pendingMessages.length > 0) {
-					for (const message of pendingMessages) {
-						await emitEvent(emit, {
-							type: "message.start",
-							message
-						});
-						for (const [partIndex, part] of message.parts.entries()) {
-							await emitEvent(emit, {
-								type: "message.part.start",
-								message,
-								partIndex,
-								part
-							});
-							await emitEvent(emit, {
-								type: "message.part.end",
-								message,
-								partIndex,
-								part
-							});
-							await emitEvent(emit, {
-								type: "message.update",
-								message
-							});
-						}
-						await emitEvent(emit, {
-							type: "message.end",
-							message
-						});
-						currentContext.messages.push(message);
-						newMessages.push(message);
-					}
-					pendingMessages = [];
+			let params = buildParams(model, context, isOAuthToken, options);
+			const nextParams = await options?.onPayload?.(params, model);
+			if (nextParams !== void 0) params = nextParams;
+			const anthropicStream = client.messages.stream({
+				...params,
+				stream: true
+			}, { signal: options?.signal });
+			stream.push({
+				type: "start",
+				partial: output
+			});
+			const blocks = output.parts;
+			for await (const event of anthropicStream) if (event.type === "message_start") {
+				output.responseId = event.message.id;
+				output.usage.input = event.message.usage.input_tokens || 0;
+				output.usage.output = event.message.usage.output_tokens || 0;
+				output.usage.cacheRead = event.message.usage.cache_read_input_tokens || 0;
+				output.usage.cacheWrite = event.message.usage.cache_creation_input_tokens || 0;
+				output.usage.totalTokens = output.usage.input + output.usage.output + output.usage.cacheRead + output.usage.cacheWrite;
+				Model.calculateCost(model, output.usage);
+			} else if (event.type === "content_block_start") {
+				if (event.content_block.type === "text") {
+					const block = {
+						type: "text",
+						text: "",
+						index: event.index
+					};
+					output.parts.push(block);
+					stream.push({
+						type: "text.start",
+						partIndex: output.parts.length - 1,
+						partial: output
+					});
+				} else if (event.content_block.type === "thinking") {
+					const block = {
+						type: "thinking",
+						thinking: "",
+						thinkingSignature: "",
+						index: event.index
+					};
+					output.parts.push(block);
+					stream.push({
+						type: "thinking.start",
+						partIndex: output.parts.length - 1,
+						partial: output
+					});
+				} else if (event.content_block.type === "redacted_thinking") {
+					const block = {
+						type: "thinking",
+						thinking: "[Reasoning redacted]",
+						thinkingSignature: event.content_block.data,
+						redacted: true,
+						index: event.index
+					};
+					output.parts.push(block);
+					stream.push({
+						type: "thinking.start",
+						partIndex: output.parts.length - 1,
+						partial: output
+					});
+				} else if (event.content_block.type === "tool_use") {
+					const block = {
+						type: "toolCall",
+						callID: event.content_block.id,
+						name: isOAuthToken ? fromClaudeCodeName(event.content_block.name, context.tools) : event.content_block.name,
+						arguments: event.content_block.input ?? {},
+						partialJson: "",
+						status: "pending",
+						time: {
+							start: Date.now(),
+							end: Date.now()
+						},
+						index: event.index
+					};
+					output.parts.push(block);
+					stream.push({
+						type: "toolcall.start",
+						partIndex: output.parts.length - 1,
+						partial: output
+					});
 				}
-				const message = await streamAssistantResponse(config, currentContext, emit, streamFn, signal);
-				if (message.stopReason === "error" || message.stopReason === "aborted") {
-					currentContext.messages.push(message);
-					newMessages.push(message);
-					await emitEvent(emit, {
-						type: "turn.end",
-						message
+			} else if (event.type === "content_block_delta") {
+				const partIndex = blocks.findIndex((b) => b.index === event.index);
+				const block = blocks[partIndex];
+				if (!block) continue;
+				if (event.delta.type === "text_delta" && block.type === "text") {
+					block.text += event.delta.text;
+					stream.push({
+						type: "text.delta",
+						partIndex,
+						delta: event.delta.text,
+						partial: output
 					});
-					await emitEvent(emit, {
-						type: "agent.end",
-						messages: newMessages
+				} else if (event.delta.type === "thinking_delta" && block.type === "thinking") {
+					block.thinking += event.delta.thinking;
+					stream.push({
+						type: "thinking.delta",
+						partIndex,
+						delta: event.delta.thinking,
+						partial: output
+					});
+				} else if (event.delta.type === "input_json_delta" && block.type === "toolCall") {
+					block.partialJson += event.delta.partial_json;
+					block.arguments = parseStreamingJson(block.partialJson);
+					stream.push({
+						type: "toolcall.delta",
+						partIndex,
+						delta: event.delta.partial_json,
+						partial: output
+					});
+				} else if (event.delta.type === "signature_delta" && block.type === "thinking") {
+					block.thinkingSignature = block.thinkingSignature || "";
+					block.thinkingSignature += event.delta.signature;
+				}
+			} else if (event.type === "content_block_stop") {
+				const partIndex = blocks.findIndex((b) => b.index === event.index);
+				const block = blocks[partIndex];
+				if (block) {
+					delete block.index;
+					if (block.type === "text") stream.push({
+						type: "text.end",
+						partIndex,
+						content: block.text,
+						partial: output
+					});
+					else if (block.type === "thinking") stream.push({
+						type: "thinking.end",
+						partIndex,
+						content: block.thinking,
+						partial: output
 					});
-					return;
+					else if (block.type === "toolCall") {
+						block.arguments = parseStreamingJson(block.partialJson);
+						delete block.partialJson;
+						stream.push({
+							type: "toolcall.end",
+							partIndex,
+							toolCall: block,
+							partial: output
+						});
+					}
 				}
-				const toolCalls = message.parts.map((part, index) => ({
-					...part,
-					partIndex: index
-				})).filter((part) => part.type === "toolCall" && part.status === "pending");
-				hasMoreToolCalls = toolCalls.length > 0;
-				if (hasMoreToolCalls) await executeToolCalls(config, currentContext, message, toolCalls, emit, signal);
-				currentContext.messages.push(message);
-				newMessages.push(message);
-				await emitEvent(emit, {
-					type: "turn.end",
-					message
-				});
-				pendingMessages = await config.getSteeringMessages?.() || [];
-			}
-			const followUpMessages = await config.getFollowUpMessages?.() || [];
-			if (followUpMessages.length > 0) {
-				pendingMessages = followUpMessages;
-				continue;
+			} else if (event.type === "message_delta") {
+				if (event.delta.stop_reason) output.stopReason = mapStopReason(event.delta.stop_reason);
+				if (event.usage.input_tokens != null) output.usage.input = event.usage.input_tokens;
+				if (event.usage.output_tokens != null) output.usage.output = event.usage.output_tokens;
+				if (event.usage.cache_read_input_tokens != null) output.usage.cacheRead = event.usage.cache_read_input_tokens;
+				if (event.usage.cache_creation_input_tokens != null) output.usage.cacheWrite = event.usage.cache_creation_input_tokens;
+				output.usage.totalTokens = output.usage.input + output.usage.output + output.usage.cacheRead + output.usage.cacheWrite;
+				Model.calculateCost(model, output.usage);
 			}
-			break;
-		}
-		await emitEvent(emit, {
-			type: "agent.end",
-			messages: newMessages
-		});
-	}
-	async function runAgentLoop(config, context, prompts, emit, streamFn, signal) {
-		/**
-		* maintain 2 arrays to represent state, `context` the actual full state sent to the LLM,
-		* `newMessages` for intermediate current loop state.
-		* think of newMessages as subset of context.messages for the running current loop.
-		* they do move at the same speed staring with initial user prompts.
-		* */
-		const newMessages = [...prompts];
-		const currentContext = {
-			...context,
-			messages: [...context.messages, ...prompts]
-		};
-		await emitEvent(emit, { type: "agent.start" });
-		await emitEvent(emit, { type: "turn.start" });
-		for (const prompt of prompts) {
-			await emitEvent(emit, {
-				type: "message.start",
-				message: prompt
+			if (options?.signal?.aborted) throw new Error("Request was aborted");
+			if (output.stopReason === "aborted" || output.stopReason === "error") throw new Error("An unknown error occurred");
+			output.time.completed = Date.now();
+			stream.push({
+				type: "done",
+				reason: output.stopReason,
+				message: output
 			});
-			for (const [partIndex, part] of prompt.parts.entries()) {
-				await emitEvent(emit, {
-					type: "message.part.start",
-					message: prompt,
-					partIndex,
-					part
-				});
-				await emitEvent(emit, {
-					type: "message.part.end",
-					message: prompt,
-					partIndex,
-					part
-				});
-			}
-			await emitEvent(emit, {
-				type: "message.end",
-				message: prompt
+			stream.end();
+		} catch (error) {
+			for (const block of output.parts) delete block.index;
+			output.time.completed = Date.now();
+			output.stopReason = options?.signal?.aborted ? "aborted" : "error";
+			output.errorMessage = error instanceof Error ? error.message : JSON.stringify(error);
+			stream.push({
+				type: "error",
+				reason: output.stopReason,
+				error: output
 			});
+			stream.end();
 		}
-		await runLoop(config, currentContext, newMessages, emit, streamFn, signal);
-		return newMessages;
-	}
-	_Loop.runAgentLoop = runAgentLoop;
-	async function runAgentLoopContinue(config, context, emit, streamFn, signal) {
-		if (context.messages.length === 0) throw new AgentContextError({ message: "connot continue: no messages in context" });
-		if (context.messages[context.messages.length - 1]?.role === "assistant") throw new AgentContextError({ message: "cannot continue from message role: assistant" });
-		const newMessages = [];
-		const currentContext = { ...context };
-		await emitEvent(emit, { type: "agent.start" });
-		await emitEvent(emit, { type: "turn.start" });
-		await runLoop(config, currentContext, newMessages, emit, streamFn, signal);
-		return newMessages;
-	}
-	_Loop.runAgentLoopContinue = runAgentLoopContinue;
-	function run(config, context, prompts, streamFn, signal) {
-		const stream = createAgentStream();
-		runAgentLoop(config, context, prompts, async (event) => {
-			stream.push(event);
-		}, streamFn, signal).then((messages) => {
-			stream.end(messages);
-		});
-		return stream;
-	}
-	_Loop.run = run;
-	function runContinue(config, context, streamFn, signal) {
-		const stream = createAgentStream();
-		runAgentLoopContinue(config, context, async (event) => {
-			stream.push(event);
-		}, streamFn, signal).then((messages) => {
-			stream.end(messages);
-		});
-		return stream;
-	}
-	_Loop.runContinue = runContinue;
-})(Loop || (Loop = {}));
+	})();
+	return stream;
+};
+const streamSimpleAnthropic = (model, context, options) => {
+	const apiKey = options?.apiKey || getEnvApiKey(model.provider);
+	if (!apiKey) throw new Error(`No API key for provider: ${model.provider.id}`);
+	const base = Stream.buildBaseOptions(model, options, apiKey);
+	if (!options?.reasoning) return streamAnthropic(model, context, {
+		...base,
+		thinkingEnabled: false
+	});
+	const adjusted = Stream.adjustMaxTokensForThinking(base.maxTokens || 0, model.maxTokens, options.reasoning, options.thinkingBudgets);
+	return streamAnthropic(model, context, {
+		...base,
+		maxTokens: adjusted.maxTokens,
+		thinkingEnabled: true,
+		thinkingBudgetTokens: adjusted.thinkingBudget
+	});
+};
+//#endregion
+//#region src/provider/register.ts
+const providerModules = [["providers/anthropic/index.ts", {
+	protocol: Model.KnownProtocolEnum.anthropicMessages,
+	stream: streamAnthropic,
+	streamSimple: streamSimpleAnthropic
+}]];
+for (const [path, provider] of providerModules) Stream.registerProtocolProvider(provider, path);
 //#endregion
 //#region src/agent/agent.ts
 let Agent;
@@ -1849,7 +1874,6 @@ let Agent;
 		_state;
 		listeners = /* @__PURE__ */ new Set();
 		abortController;
-		activeAssistantIndex;
 		convertToLlm;
 		transformContext;
 		steeringQueue = [];
@@ -2001,19 +2025,34 @@ let Agent;
 		}
 		replaceMessages(ms) {
 			this._state.messages = ms.slice();
-			this.activeAssistantIndex = void 0;
 		}
 		appendMessage(m) {
 			this._state.messages = [...this._state.messages, m];
 		}
-		patchStoredAssistantPart(partIndex, part) {
-			if (this.activeAssistantIndex === void 0) return false;
+		findMessageIndexById(messageId) {
+			return this._state.messages.findIndex((message) => message.messageId === messageId);
+		}
+		replaceMessageById(message) {
+			const messageIndex = this.findMessageIndexById(message.messageId);
+			if (messageIndex === -1) return false;
+			const messages = this._state.messages.slice();
+			messages[messageIndex] = message;
+			this._state.messages = messages;
+			return true;
+		}
+		upsertMessage(message) {
+			if (this.replaceMessageById(message)) return;
+			this.appendMessage(message);
+		}
+		patchStoredAssistantPart(messageId, partIndex, part) {
+			const messageIndex = this.findMessageIndexById(messageId);
+			if (messageIndex === -1) return false;
 			const messages = this._state.messages.slice();
-			const existing = messages[this.activeAssistantIndex];
+			const existing = messages[messageIndex];
 			if (!existing || existing.role !== "assistant") return false;
 			const nextParts = existing.parts.slice();
 			nextParts[partIndex] = part;
-			messages[this.activeAssistantIndex] = {
+			messages[messageIndex] = {
 				...existing,
 				parts: nextParts
 			};
@@ -2076,7 +2115,6 @@ let Agent;
 		}
 		clearMessages() {
 			this._state.messages = [];
-			this.activeAssistantIndex = void 0;
 		}
 		abort() {
 			this.abortController?.abort();
@@ -2090,7 +2128,6 @@ let Agent;
 			this._state.streamMessage = null;
 			this._state.pendingToolCalls = /* @__PURE__ */ new Set();
 			this._state.error = void 0;
-			this.activeAssistantIndex = void 0;
 			this.steeringQueue = [];
 			this.followUpQueue = [];
 		}
@@ -2147,7 +2184,7 @@ let Agent;
 				if (messages) await Loop.runAgentLoop(config, context, messages, async (e) => this._processLoopEvent(e), this.streamFn, this.abortController.signal);
 				else await Loop.runAgentLoopContinue(config, context, async (e) => this._processLoopEvent(e), this.streamFn, this.abortController.signal);
 			} catch (err) {
-				const message = {
+				const message = Message.createAssistantMessage({
 					role: "assistant",
 					protocol: model.protocol,
 					provider: model.provider,
@@ -2173,7 +2210,7 @@ let Agent;
 						completed: Date.now()
 					},
 					parts: []
-				};
+				});
 				this.appendMessage(message);
 				this._state.error = err?.message || String(err);
 				this.emit({
@@ -2201,32 +2238,31 @@ let Agent;
 		async prompt(messages, images) {
 			this.ensureIdle();
 			if (!this._state.model) throw new ModelNotConfiguredErr({ message: "no model configured yet." });
-			const message = {
+			const message = Message.createUserMessage({
 				role: "user",
 				time: { created: Date.now() },
 				parts: [...messages, ...images ?? []]
-			};
+			});
 			await this.loop([message]);
 		}
 		_processLoopEvent(event) {
 			switch (event.type) {
 				case "message.start":
 					this._state.streamMessage = event.message;
-					if (event.message.role === "assistant") this.activeAssistantIndex = void 0;
 					break;
 				case "message.part.start":
 				case "message.part.update":
 				case "message.part.end":
 					this._state.streamMessage = event.message;
-					if (event.message.role === "assistant") this.patchStoredAssistantPart(event.partIndex, event.part);
+					if (event.message.role === "assistant") this.patchStoredAssistantPart(event.message.messageId, event.partIndex, event.part);
 					break;
 				case "message.update":
 					this._state.streamMessage = event.message;
+					this.replaceMessageById(event.message);
 					break;
 				case "message.end":
 					this._state.streamMessage = null;
-					this.appendMessage(event.message);
-					if (event.message.role === "assistant") this.activeAssistantIndex = this._state.messages.length - 1;
+					this.upsertMessage(event.message);
 					break;
 				case "tool.execution.start": {
 					const pendingToolCalls = new Set(this._state.pendingToolCalls);
@@ -2271,207 +2307,353 @@ let Agent;
 	_Agent.create = create;
 })(Agent || (Agent = {}));
 //#endregion
-//#region src/agent.ts
-const agent = {
-	create: Agent.create,
-	loop: Loop.run,
-	loopContinue: Loop.runContinue
-};
-//#endregion
-//#region src/event/event.ts
-let Event;
-(function(_Event) {
-	const LLMMessageEventType = _Event.LLMMessageEventType = {
-		start: "start",
-		textStart: "text.start",
-		textDelta: "text.delta",
-		textEnd: "text.end",
-		thinkingStart: "thinking.start",
-		thinkingDelta: "thinking.delta",
-		thinkingEnd: "thinking.end",
-		toolcallStart: "toolcall.start",
-		toolcallDelta: "toolcall.delta",
-		toolcallEnd: "toolcall.end",
-		done: "done",
-		error: "error"
-	};
-	_Event.LLMMessageEventSchema = Type.Union([
-		Type.Object({
-			type: Type.Literal(LLMMessageEventType.start),
-			partial: Message.AssistantMessageSchema
-		}),
-		Type.Object({
-			type: Type.Literal(LLMMessageEventType.textStart),
-			partIndex: Type.Number(),
-			partial: Message.AssistantMessageSchema
-		}),
-		Type.Object({
-			type: Type.Literal(LLMMessageEventType.textDelta),
-			partIndex: Type.Number(),
-			delta: Type.String(),
-			partial: Message.AssistantMessageSchema
-		}),
-		Type.Object({
-			type: Type.Literal(LLMMessageEventType.textEnd),
-			partIndex: Type.Number(),
-			content: Type.String(),
-			partial: Message.AssistantMessageSchema
-		}),
-		Type.Object({
-			type: Type.Literal(LLMMessageEventType.thinkingStart),
-			partIndex: Type.Number(),
-			partial: Message.AssistantMessageSchema
-		}),
-		Type.Object({
-			type: Type.Literal(LLMMessageEventType.thinkingDelta),
-			partIndex: Type.Number(),
-			delta: Type.String(),
-			partial: Message.AssistantMessageSchema
-		}),
-		Type.Object({
-			type: Type.Literal(LLMMessageEventType.thinkingEnd),
-			partIndex: Type.Number(),
-			content: Type.String(),
-			partial: Message.AssistantMessageSchema
-		}),
-		Type.Object({
-			type: Type.Literal(LLMMessageEventType.toolcallStart),
-			partIndex: Type.Number(),
-			partial: Message.AssistantMessageSchema
-		}),
-		Type.Object({
-			type: Type.Literal(LLMMessageEventType.toolcallDelta),
-			partIndex: Type.Number(),
-			delta: Type.String(),
-			partial: Message.AssistantMessageSchema
-		}),
-		Type.Object({
-			type: Type.Literal(LLMMessageEventType.toolcallEnd),
-			partIndex: Type.Number(),
-			toolCall: Message.ToolCallSchema,
-			partial: Message.AssistantMessageSchema
-		}),
-		Type.Object({
-			type: Type.Literal(LLMMessageEventType.done),
-			reason: Type.Union([
-				Type.Literal("stop"),
-				Type.Literal("length"),
-				Type.Literal("toolUse")
-			]),
-			message: Message.AssistantMessageSchema
-		}),
-		Type.Object({
-			type: Type.Literal(LLMMessageEventType.error),
-			reason: Type.Union([Type.Literal("aborted"), Type.Literal("error")]),
-			error: Message.AssistantMessageSchema
-		})
-	]);
-	const AgentEventType = _Event.AgentEventType = {
-		agentStart: "agent.start",
-		agentEnd: "agent.end",
-		turnStart: "turn.start",
-		turnEnd: "turn.end",
-		messageStart: "message.start",
-		messagePartStart: "message.part.start",
-		messagePartUpdate: "message.part.update",
-		messagePartEnd: "message.part.end",
-		messageUpdate: "message.update",
-		messageEnd: "message.end",
-		toolExecutionStart: "tool.execution.start",
-		toolExecutionUpdate: "tool.execution.update",
-		toolExecutionEnd: "tool.execution.end"
-	};
-	const UserMessagePart = Type.Union([Message.TextContentSchema, Message.ImageContentSchema]);
-	const AssistantMessagePart = Type.Union([
-		Message.TextContentSchema,
-		Message.ImageContentSchema,
-		Message.ThinkingContentSchema,
-		Message.ToolCallSchema
-	]);
-	const UserMessagePartStart = Type.Object({
-		type: Type.Literal(AgentEventType.messagePartStart),
-		message: Message.UserMessageSchema,
-		partIndex: Type.Number(),
-		part: UserMessagePart
-	});
-	const UserMessagePartEnd = Type.Object({
-		type: Type.Literal(AgentEventType.messagePartEnd),
-		message: Message.UserMessageSchema,
-		partIndex: Type.Number(),
-		part: UserMessagePart
-	});
-	const AssistantMessagePartStart = Type.Object({
-		type: Type.Literal(AgentEventType.messagePartStart),
-		message: Message.AssistantMessageSchema,
-		partIndex: Type.Number(),
-		part: AssistantMessagePart
-	});
-	const AssistantMessagePartLLMUpdate = Type.Object({
-		type: Type.Literal(AgentEventType.messagePartUpdate),
-		message: Message.AssistantMessageSchema,
-		partIndex: Type.Number(),
-		part: AssistantMessagePart,
-		source: Type.Literal("llm")
-	});
-	const AssistantMessagePartToolUpdate = Type.Object({
-		type: Type.Literal(AgentEventType.messagePartUpdate),
-		message: Message.AssistantMessageSchema,
-		partIndex: Type.Number(),
-		part: AssistantMessagePart,
-		source: Type.Literal("tool")
+//#region src/agent/codemode/codemode.ts
+let CodeMode;
+(function(_CodeMode) {
+	const ToolDefinitionErr = _CodeMode.ToolDefinitionErr = NamedError.create("ToolDefinitionErr", Type.Object({ message: Type.String() }));
+	const toolFnPrefix = process.env.CODEWORK_CODEMODE_FN_PREFIX ?? "external_";
+	const SandboxExecutionInputSchema = _CodeMode.SandboxExecutionInputSchema = Type.Object({ typescriptCode: Type.String({ description: "TypeScript code to execute in the sandbox." }) });
+	const SandboxExecutionOutputSchema = _CodeMode.SandboxExecutionOutputSchema = Type.Object({
+		result: Type.Optional(Type.Unknown()),
+		logs: Type.Optional(Type.Array(Type.String()))
 	});
-	const AssistantMessagePartEnd = Type.Object({
-		type: Type.Literal(AgentEventType.messagePartEnd),
-		message: Message.AssistantMessageSchema,
-		partIndex: Type.Number(),
-		part: AssistantMessagePart
+	const SandboxExecutionErrorSchema = _CodeMode.SandboxExecutionErrorSchema = Type.Object({
+		message: Type.String(),
+		name: Type.Optional(Type.String()),
+		stack: Type.Optional(Type.String()),
+		line: Type.Optional(Type.Number()),
+		logs: Type.Optional(Type.Array(Type.String()))
 	});
-	const ToolExecutionStartSchema = Type.Composite([Agent.ToolCallInFlightSchema, Type.Object({ type: Type.Literal(AgentEventType.toolExecutionStart) })]);
-	const ToolExecutionUpdateSchema = Type.Composite([
-		Agent.ToolCallInFlightSchema,
-		Type.Object({ type: Type.Literal(AgentEventType.toolExecutionUpdate) }),
-		Message.ToolRunningSchema
-	]);
-	const ToolExecutionEndSchema = Type.Composite([
-		Agent.ToolCallInFlightSchema,
-		Type.Object({ type: Type.Literal(AgentEventType.toolExecutionEnd) }),
-		Type.Union([Message.ToolCompletedSchema, Message.ToolErrorSchema])
-	]);
-	_Event.AgentEventSchema = Type.Union([
-		Type.Object({ type: Type.Literal(AgentEventType.agentStart) }),
-		Type.Object({
-			type: Type.Literal(AgentEventType.agentEnd),
-			messages: Type.Array(Message.MessageSchema)
-		}),
-		Type.Object({ type: Type.Literal(AgentEventType.turnStart) }),
-		Type.Object({
-			type: Type.Literal(AgentEventType.turnEnd),
-			message: Message.AssistantMessageSchema
-		}),
-		Type.Object({
-			type: Type.Literal(AgentEventType.messageStart),
-			message: Message.MessageSchema
-		}),
-		Type.Union([UserMessagePartStart, UserMessagePartEnd]),
-		Type.Union([
-			AssistantMessagePartStart,
-			AssistantMessagePartLLMUpdate,
-			AssistantMessagePartToolUpdate,
-			AssistantMessagePartEnd
-		]),
-		Type.Object({
-			type: Type.Literal(AgentEventType.messageUpdate),
-			message: Message.MessageSchema
-		}),
-		Type.Object({
-			type: Type.Literal(AgentEventType.messageEnd),
-			message: Message.MessageSchema
-		}),
-		ToolExecutionStartSchema,
-		ToolExecutionUpdateSchema,
-		ToolExecutionEndSchema
-	]);
-})(Event || (Event = {}));
+	function withMessageInStack(message, stack) {
+		if (!stack) return void 0;
+		return stack.includes(message) ? stack : `${message}\n${stack}`;
+	}
+	function normalizeExecutionError(error) {
+		if (error instanceof Error) return {
+			name: error.name,
+			message: error.message,
+			stack: withMessageInStack(error.message, error.stack),
+			line: parseErrorLine(error.stack)
+		};
+		if (typeof error === "object" && error !== null) {
+			const candidate = error;
+			return {
+				name: typeof candidate.name === "string" ? candidate.name : void 0,
+				message: typeof candidate.message === "string" ? candidate.message : JSON.stringify(candidate) || "Unknown execution error",
+				stack: typeof candidate.stack === "string" ? withMessageInStack(typeof candidate.message === "string" ? candidate.message : JSON.stringify(candidate) || "Unknown execution error", candidate.stack) : void 0,
+				line: typeof candidate.line === "number" ? candidate.line : parseErrorLine(candidate.stack)
+			};
+		}
+		return {
+			name: "Error",
+			message: String(error)
+		};
+	}
+	function parseErrorLine(stack) {
+		if (typeof stack !== "string") return void 0;
+		const lineMatch = stack.match(/:(\d+)(?::\d+)?\)?$/m);
+		return lineMatch ? Number(lineMatch[1]) : void 0;
+	}
+	function serializeForContent(value) {
+		return JSON.stringify(value, (_key, currentValue) => typeof currentValue === "bigint" ? currentValue.toString() : currentValue, 2);
+	}
+	function toolContentToText(result) {
+		return result.content.filter((part) => part.type === "text" && typeof part.text === "string").map((part) => part.text).join("\n").trim();
+	}
+	function unwrapToolResult(tool, result) {
+		if (result.status === "completed") {
+			if (tool.outputSchema) return validateSchema(tool.outputSchema, result.result.details, `Tool "${tool.name}" output`);
+			return result.result.details;
+		}
+		if (tool.errorSchema && result.result.details !== void 0) validateSchema(tool.errorSchema, result.result.details, `Tool "${tool.name}" error`);
+		const message = toolContentToText(result.result) || `Tool "${tool.name}" failed`;
+		const error = new Error(message);
+		if (result.result.details !== void 0) error.cause = result.result.details;
+		throw error;
+	}
+	function toolToBinding(tool, prefix = "") {
+		const inputSchema = TypeGuard.IsSchema(tool.parameters) ? tool.parameters : Type.Object({});
+		const outputSchema = TypeGuard.IsSchema(tool.outputSchema) ? tool.outputSchema : void 0;
+		const errorSchema = TypeGuard.IsSchema(tool.errorSchema) ? tool.errorSchema : void 0;
+		if (!("execute" in tool) || typeof tool.execute !== "function") throw new ToolDefinitionErr({ message: `tool "${tool.name}" does not have an execute function. code mode requires tools with implementation` });
+		return {
+			name: `${prefix}${tool.name}`,
+			description: tool.description,
+			inputSchema,
+			outputSchema,
+			errorSchema,
+			execute: async (callID, params, signal) => {
+				const validatedParams = validateSchema(inputSchema, params, `Tool "${tool.name}" input`);
+				return unwrapToolResult(tool, await tool.execute(callID, validatedParams, signal));
+			}
+		};
+	}
+	function toolsForBinding(tools, prefix) {
+		const bindings = {};
+		for (const tool of tools) {
+			const name = `${prefix}${tool.name}`;
+			bindings[name] = toolToBinding(tool, prefix);
+		}
+		return bindings;
+	}
+	function indent(value, depth = 1) {
+		const prefix = "	".repeat(depth);
+		return value.split("\n").map((line) => `${prefix}${line}`).join("\n");
+	}
+	function toPropertyKey(name) {
+		return /^[$A-Z_a-z][$\w]*$/i.test(name) ? name : JSON.stringify(name);
+	}
+	function schemaToTypeScript(schema) {
+		if (TypeGuard.IsAny(schema)) return "any";
+		if (TypeGuard.IsUnknown(schema)) return "unknown";
+		if (TypeGuard.IsString(schema)) return "string";
+		if (TypeGuard.IsNumber(schema) || TypeGuard.IsInteger(schema)) return "number";
+		if (TypeGuard.IsBoolean(schema)) return "boolean";
+		if (TypeGuard.IsNull(schema)) return "null";
+		if (TypeGuard.IsUndefined(schema) || TypeGuard.IsVoid(schema)) return "undefined";
+		if (TypeGuard.IsLiteral(schema)) return JSON.stringify(schema.const);
+		if (TypeGuard.IsArray(schema)) return `Array<${schemaToTypeScript(schema.items)}>`;
+		if (TypeGuard.IsTuple(schema)) return `[${(schema.items ?? []).map((item) => schemaToTypeScript(item)).join(", ")}]`;
+		if (TypeGuard.IsUnion(schema)) return schema.anyOf.map((item) => schemaToTypeScript(item)).join(" | ");
+		if (TypeGuard.IsIntersect(schema)) return schema.allOf.map((item) => schemaToTypeScript(item)).join(" & ");
+		if (TypeGuard.IsRecord(schema)) return `Record<string, ${schemaToTypeScript(Object.values(schema.patternProperties ?? {}).find(TypeGuard.IsSchema) ?? (schema.additionalProperties && TypeGuard.IsSchema(schema.additionalProperties) ? schema.additionalProperties : Type.Unknown()))}>`;
+		if (TypeGuard.IsObject(schema)) {
+			const required = new Set(schema.required ?? []);
+			const properties = Object.entries(schema.properties ?? {}).map(([key, value]) => {
+				const optional = required.has(key) ? "" : "?";
+				return `${toPropertyKey(key)}${optional}: ${schemaToTypeScript(value)};`;
+			});
+			if (schema.additionalProperties === true) properties.push("[key: string]: unknown;");
+			else if (schema.additionalProperties && TypeGuard.IsSchema(schema.additionalProperties)) properties.push(`[key: string]: ${schemaToTypeScript(schema.additionalProperties)};`);
+			if (properties.length === 0) return "{}";
+			return `{\n${indent(properties.join("\n"))}\n}`;
+		}
+		return "unknown";
+	}
+	function generateTypeStubs(bindings, options = {}) {
+		const { includeDescriptions = true } = options;
+		const declarations = [];
+		for (const [name, binding] of Object.entries(bindings)) {
+			const inputTypeName = `${capitalize(name)}Input`;
+			const outputTypeName = `${capitalize(name)}Output`;
+			declarations.push(`type ${inputTypeName} = ${schemaToTypeScript(binding.inputSchema)};`);
+			let outputTypeRef = "unknown";
+			if (binding.outputSchema !== void 0) {
+				declarations.push(`type ${outputTypeName} = ${schemaToTypeScript(binding.outputSchema)};`);
+				outputTypeRef = outputTypeName;
+			}
+			const description = includeDescriptions && binding.description ? `/** ${binding.description} */\n` : "";
+			declarations.push(`${description}declare function ${name}(input: ${inputTypeName}): Promise<${outputTypeRef}>;`);
+		}
+		return declarations.join("\n\n");
+	}
+	_CodeMode.generateTypeStubs = generateTypeStubs;
+	function buildExampleSnippet() {
+		return [
+			"```typescript",
+			"const numbers = [12, 24, 36];",
+			"const total = numbers.reduce((sum, value) => sum + value, 0);",
+			"",
+			"return {",
+			"  count: numbers.length,",
+			"  average: total / numbers.length,",
+			"};",
+			"```"
+		];
+	}
+	function generateSystemPrompt(config) {
+		const fnPrefix = config.fnPrefix ?? toolFnPrefix;
+		const bindings = toolsForBinding(config.tools, fnPrefix);
+		const typeStubs = generateTypeStubs(bindings);
+		return [
+			"## Code Execution Tool",
+			"",
+			"You have access to `sandbox_execute_typescript` which runs TypeScript code in a sandboxed environment.",
+			"",
+			"### When to Use",
+			"",
+			"Use `sandbox_execute_typescript` when you need to:",
+			"- Process data with loops, conditionals, or complex logic",
+			"- Make multiple tool calls in parallel with `Promise.all(...)`",
+			"- Transform, filter, or aggregate data",
+			"- Perform calculations or data analysis",
+			"",
+			"For simple operations, prefer calling tools directly.",
+			"",
+			"### Available External APIs",
+			"",
+			"Inside your TypeScript code, you can call these async functions:",
+			"",
+			Object.entries(bindings).map(([name, binding]) => `- \`${name}(input)\`: ${binding.description}`).join("\n") || "- No external APIs available for this run.",
+			"",
+			"### Type Definitions",
+			"",
+			"```typescript",
+			typeStubs,
+			"```",
+			"",
+			"### Example",
+			"",
+			...buildExampleSnippet(),
+			"",
+			"### Important Notes",
+			"",
+			`- All\`${fnPrefix}\`*calls are async, so always use \`await\``,
+			"- Return a value to pass results back to you",
+			"- Use `console.log()` for debugging (logs are captured)",
+			"- The sandbox is isolated - no network access or file system",
+			"- Each execution is isolated and does not share state with previous runs",
+			""
+		].join("\n");
+	}
+	_CodeMode.generateSystemPrompt = generateSystemPrompt;
+	async function transpileTypeScript(typescriptCode) {
+		return (await transform([
+			"(async () => {",
+			"	const __codemodeNormalizeError = (error: unknown) => {",
+			"		if (error instanceof Error) return { name: error.name, message: error.message, stack: error.stack };",
+			"		if (typeof error === 'object' && error !== null) {",
+			"			const candidate = error as { name?: unknown; message?: unknown; stack?: unknown };",
+			"			return {",
+			"				name: typeof candidate.name === 'string' ? candidate.name : 'Error',",
+			"				message:",
+			"					typeof candidate.message === 'string'",
+			"						? candidate.message",
+			"						: JSON.stringify(candidate) || 'Unknown execution error',",
+			"				stack: typeof candidate.stack === 'string' ? candidate.stack : undefined,",
+			"			};",
+			"		}",
+			"		return { name: 'Error', message: String(error) };",
+			"	};",
+			"	try {",
+			typescriptCode,
+			"	} catch (error) {",
+			"		throw __codemodeNormalizeError(error);",
+			"	}",
+			"})()"
+		].join("\n"), {
+			loader: "ts",
+			target: "es2022",
+			sourcefile: "script.ts",
+			minify: false,
+			keepNames: false
+		})).code;
+	}
+	function buildToolDescription(tools, fnPrefix = toolFnPrefix) {
+		return [
+			"Execute TypeScript code in a secure sandbox environment. ",
+			"The code can use these external API functions:",
+			"<functions>",
+			` ${tools.map((tool) => `${fnPrefix}${tool.name}`).join("\n")}`,
+			"</functions>",
+			`All ${fnPrefix}* calls are async and must be awaited. `,
+			"Return a value to pass results back. Use console.log() for debugging."
+		].join("\n");
+	}
+	function createCodeModeTool(config) {
+		if (config.tools.length === 0) throw new ToolDefinitionErr({ message: "at least one tool must be provided to `createCodeModeTool`" });
+		return Agent.defineTool({
+			name: "sandbox_execute_typescript",
+			label: "Sandbox TypeScript",
+			description: buildToolDescription(config.tools, config.fnPrefix),
+			parameters: SandboxExecutionInputSchema,
+			outputSchema: SandboxExecutionOutputSchema,
+			errorSchema: SandboxExecutionErrorSchema,
+			async execute(_callID, params, signal, onUpdate) {
+				const bindings = toolsForBinding(config.tools, config.fnPrefix ?? toolFnPrefix);
+				let context;
+				try {
+					await onUpdate?.({
+						status: "running",
+						partial: { content: [{
+							type: "text",
+							text: "Transpiling TypeScript for sandbox execution"
+						}] }
+					});
+					const javascriptCode = await transpileTypeScript(params.typescriptCode);
+					await onUpdate?.({
+						status: "running",
+						partial: { content: [{
+							type: "text",
+							text: "Executing code in sandbox runtime"
+						}] }
+					});
+					context = await config.driver.createContext({
+						bindings,
+						timeout: config.timeout,
+						memoryLimit: config.memoryLimit,
+						signal
+					});
+					const executionResult = await context.execute(javascriptCode);
+					if (executionResult.success) {
+						const details = {
+							result: executionResult.value,
+							...executionResult.logs && executionResult.logs.length > 0 ? { logs: executionResult.logs } : {}
+						};
+						return {
+							status: "completed",
+							result: {
+								content: [{
+									type: "text",
+									text: serializeForContent(details)
+								}],
+								details,
+								isError: false
+							}
+						};
+					}
+					const details = {
+						message: executionResult.error?.message || "sandbox execution failed",
+						...executionResult.error?.name ? { name: executionResult.error.name } : {},
+						...executionResult.error?.stack ? { stack: executionResult.error.stack } : {},
+						...executionResult.error?.line != null ? { line: executionResult.error.line } : {},
+						...executionResult.logs && executionResult.logs.length > 0 ? { logs: executionResult.logs } : {}
+					};
+					return {
+						status: "error",
+						result: {
+							content: [{
+								type: "text",
+								text: serializeForContent(details)
+							}],
+							details,
+							isError: true
+						}
+					};
+				} catch (error) {
+					const normalizedError = normalizeExecutionError(error);
+					const details = {
+						message: normalizedError.message,
+						...normalizedError.name ? { name: normalizedError.name } : {},
+						...normalizedError.stack ? { stack: normalizedError.stack } : {},
+						...normalizedError.line != null ? { line: normalizedError.line } : {}
+					};
+					return {
+						status: "error",
+						result: {
+							content: [{
+								type: "text",
+								text: serializeForContent(details)
+							}],
+							details,
+							isError: true
+						}
+					};
+				} finally {
+					await context?.dispose();
+				}
+			}
+		});
+	}
+	_CodeMode.createCodeModeTool = createCodeModeTool;
+	async function create(config) {
+		return {
+			tool: createCodeModeTool(config),
+			systemPrompt: generateSystemPrompt(config)
+		};
+	}
+	_CodeMode.create = create;
+})(CodeMode || (CodeMode = {}));
 //#endregion
 //#region src/llm.ts
 const llmImpl = async (provider, model) => Model.getModel(provider, model);
@@ -2503,13 +2685,10 @@ const stream = Object.assign(streamImpl, {
 	completeSimple: Stream.completeSimple,
 	resolveProtocolProvider: Stream.resolveProtocolProvider
 });
-/** Resolve a streamed response directly to the final assistant message. */
-const complete = Stream.complete;
-/** Start a stream using the simplified options surface. */
-const streamSimple = Stream.streamSimple;
-/** Resolve a simplified stream request directly to the final assistant message. */
-const completeSimple = Stream.completeSimple;
+Stream.complete;
+Stream.streamSimple;
+Stream.completeSimple;
 //#endregion
-export { Agent, Event, Message, Model, ModelCatalog, Stream, agent, complete, completeSimple, llm, stream, streamSimple, validateToolArguments, validateToolCall };
+export { Agent, CodeMode, Message, agent, llm, stream };
 
 //# sourceMappingURL=index.mjs.map