llmz 0.8.0 → 0.9.1

package/dist/{execute-Aw4cbIx-.js → execute-CWFIL5ny.js}

@@ -1,13 +1,13 @@
-import { a as StreamingMessageParser, i as toParsedAssistantResponse } from "./common-pgJjFu2Y.js";
-import { c as isEqual, f as toNumber } from "./dual-modes-Cy0_W4O2.js";
-import { d as Snapshot, f as parseExit, l as PartialExecutionResult, n as Context, s as ErrorExecutionResult, t as _CustomModelClient, u as SuccessExecutionResult } from "./custom-client-2V9lmzUf.js";
-import { d as stripInvalidIdentifiers, i as getErrorMessage, s as init } from "./utils-UBeAFeEI.js";
-import { t as createJsxComponent } from "./jsx-B0iYyvfr.js";
+import { a as isEqual, l as toNumber } from "./dual-modes-BNIiNLrR.js";
+import { a as ResponseParser, i as toParsedAssistantResponse } from "./common-DuEhn6u3.js";
+import { d as Snapshot, f as parseExit, l as PartialExecutionResult, n as Context, s as ErrorExecutionResult, t as _CustomModelClient, u as SuccessExecutionResult } from "./custom-client-C-nDKG37.js";
+import { d as stripInvalidIdentifiers, i as getErrorMessage, r as fromJSONSchemaCompat, s as init } from "./utils-UBeAFeEI.js";
+import { t as createJsxComponent } from "./jsx-CIgdGGVs.js";
 import { t as cleanStackTrace } from "./stack-traces-BIE_5Xwf.js";
 import { a as InvalidCodeError, c as SnapshotSignal, i as CognitiveError, l as ThinkSignal, n as CodeExecutionError, o as LoopExceededError, s as Signals, t as AssignmentError } from "./errors-Cg1G0Awu.js";
-import { n as truncateWrappedContent } from "./truncator-DZqEqnpD.js";
-import { r as hasTopLevelReturn } from "./compiler-CW1VjQsn.js";
-import { runAsyncFunction, warmupVM } from "./vm-BLsHw1da.js";
+import { n as truncateWrappedContent } from "./truncator-CD7QtE84.js";
+import { r as hasTopLevelReturn } from "./compiler-BPl-5CXh.js";
+import { runAsyncFunction, warmupVM } from "./vm-Cn3jvZ00.js";
 import { z } from "@bpinternal/zui";
 import { ulid } from "ulid";
 import { Client } from "@botpress/client";
@@ -125,47 +125,21 @@ const STREAM_INACTIVITY_TIMEOUT = 18e4;
 /** A syntactically valid prefix must not execute when generation did not finish successfully. */
 const assertSuccessfulGeneration = (metadata) => {
 	if (metadata.provider === "unknown") throw new CognitiveError("LLM generation failed: received error metadata with unknown provider");
-	if (metadata.stopReason === "max_tokens" || metadata.stopReason === "content_filter") throw new CognitiveError(`LLM generation did not complete: stopReason=${metadata.stopReason}`);
+	if (metadata.stopReason === "max_tokens" || metadata.stopReason === "content_filter" || metadata.stopReason === "other") throw new CognitiveError(`LLM generation did not complete: stopReason=${metadata.stopReason}`);
 };
 const getModelOutputLimit = (inputLength) => clamp(RESPONSE_LENGTH_BUFFER.PERCENTAGE * inputLength, RESPONSE_LENGTH_BUFFER.MIN_TOKENS, RESPONSE_LENGTH_BUFFER.MAX_TOKENS);
-/**
-* Models sometimes wrap their whole response in a code fence. The fence has to
-* be removed before it reaches the incremental parser to avoid a spurious
-* unexpected-text diagnostic. Works on arbitrary chunk boundaries
-* by holding content back until the first newline.
-*/
-var LeadingFenceFilter = class {
-	_buffer = "";
-	_done = false;
-	push(text) {
-		if (this._done) return text;
-		this._buffer += text;
-		const newline = this._buffer.indexOf("\n");
-		if (newline === -1) return "";
-		this._done = true;
-		const firstLine = this._buffer.slice(0, newline);
-		const rest = this._buffer.slice(newline + 1);
-		this._buffer = "";
-		return firstLine.trim().startsWith("```") ? rest : `${firstLine}\n${rest}`;
-	}
-	flush() {
-		if (this._done) return "";
-		this._done = true;
-		const buffered = this._buffer;
-		this._buffer = "";
-		return buffered.trim().startsWith("```") ? "" : buffered;
-	}
-};
-const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, onSend, onSendDelta, onRunStart, onRunComplete }) => {
+const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, onSend, onSendDelta, onRunStart }) => {
 	const startedAt = Date.now();
 	const traces = iteration.traces;
-	const modelRef = Array.isArray(iteration.model) ? iteration.model[0] : iteration.model;
-	const model = await cognitive.getModelDetails(modelRef).catch((thrown) => {
+	controller.signal.throwIfAborted();
+	const modelRefs = Array.isArray(iteration.model) ? iteration.model : [iteration.model];
+	const models = await Promise.all(modelRefs.map((modelRef) => cognitive.getModelDetails(modelRef).catch((thrown) => {
 		throw new CognitiveError(`Failed to fetch model details for model "${modelRef}": ${getErrorMessage(thrown)}`);
-	});
-	let modelLimit = Math.max(model.input.maxTokens, 8e3);
-	if (ctx.maxTokens) modelLimit = Math.min(ctx.maxTokens, modelLimit);
-	const responseLengthBuffer = getModelOutputLimit(modelLimit);
+	})));
+	controller.signal.throwIfAborted();
+	const model = models[0];
+	const modelLimit = Math.min(...models.map((model) => model.input.maxTokens), ctx.maxTokens ?? Infinity);
+	const responseLengthBuffer = Math.min(getModelOutputLimit(modelLimit), Math.floor(modelLimit / 2));
 	if (iteration.tokens) iteration.tokens.limit = modelLimit;
 	let messages;
 	try {
@@ -219,7 +193,7 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 	const liveContent = /* @__PURE__ */ new Map();
 	let codeGenerationTraced = false;
 	let runCompleted = false;
-	let awaitsRunResult = false;
+	let completions = [];
 	const dispatchSends = async (events) => {
 		for (const event of events) if (event.type === "item-start") {
 			liveItems.set(event.item.id, event.item);
@@ -233,7 +207,7 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 			}
 		} else if (event.type === "body-delta" && onSendDelta) {
 			const item = liveItems.get(event.itemId);
-			if ((item === null || item === void 0 ? void 0 : item.kind) !== "send" || awaitsRunResult) continue;
+			if ((item === null || item === void 0 ? void 0 : item.kind) !== "send" || runCompleted) continue;
 			const content = (liveContent.get(item.id) ?? "") + event.delta;
 			liveContent.set(item.id, content);
 			const delta = {
@@ -246,22 +220,19 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 			};
 			await preview(delta);
 		} else if (event.type === "item-complete") {
-			if (event.item.kind === "send" && onSend && !awaitsRunResult) await onSend({
-				name: event.item.name,
-				props: event.item.props,
-				body: event.item.body
-			}, messageMetadata(event.item.id));
-			else if (event.item.kind === "run" && event.item.status === "complete" && !runCompleted) {
-				runCompleted = true;
-				const code = (event.item.body ?? "").trim();
-				awaitsRunResult = hasTopLevelReturn(code);
-				onRunComplete === null || onRunComplete === void 0 || onRunComplete(code);
-			}
+			if (event.item.kind === "send" && onSend && !runCompleted) {
+				const send = {
+					name: event.item.name,
+					props: event.item.props,
+					body: event.item.body
+				};
+				const metadata = messageMetadata(event.item.id);
+				completions.push(() => onSend(send, metadata));
+			} else if (event.item.kind === "run" && event.item.status === "complete" && !runCompleted) runCompleted = true;
 		}
 	};
 	if (typeof cognitive.generateTextStream === "function") {
-		let parser = new StreamingMessageParser();
-		let fence = new LeadingFenceFilter();
+		let parser = new ResponseParser();
 		const streamController = createJoinedAbortController([controller.signal]);
 		const requestedAt = Date.now();
 		const stream = cognitive.generateTextStream({
@@ -289,6 +260,7 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 		};
 		raw = "";
 		let streamCompleted = false;
+		let accepted = false;
 		try {
 			while (true) {
 				var _chunk$value, _chunk$value2, _chunk$value3, _chunk$value4;
@@ -313,13 +285,13 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 						...chunk.value.restart
 					});
 					raw = "";
-					parser = new StreamingMessageParser();
-					fence = new LeadingFenceFilter();
+					completions = [];
+					accepted = false;
+					parser = new ResponseParser();
 					liveItems.clear();
 					liveContent.clear();
 					codeGenerationTraced = false;
 					runCompleted = false;
-					awaitsRunResult = false;
 					responseMetadata = void 0;
 					attempt = chunk.value.restart.attempt;
 					await preview({
@@ -337,29 +309,63 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 				timeToLastToken = Date.now() - requestedAt;
 				timeToFirstToken ??= timeToLastToken;
 				raw += delta;
-				await dispatchSends(parser.push(fence.push(delta)));
+				await dispatchSends(parser.push(delta));
 			}
 			if (!responseMetadata) throw new CognitiveError("LLM streaming completed without metadata");
 			assertSuccessfulGeneration(responseMetadata);
-			const remaining = fence.flush();
-			if (remaining) await dispatchSends(parser.push(remaining));
-			await dispatchSends(parser.finish());
+			await dispatchSends(parser.finish(responseMetadata.stopReason));
+			if (parser.valid) {
+				for (const complete of completions) await complete();
+				accepted = true;
+			}
 			assistantResponse = toParsedAssistantResponse(parser.items, raw, parser.diagnostics);
+		} catch (error) {
+			parser.finish();
+			const usage = (responseMetadata === null || responseMetadata === void 0 ? void 0 : responseMetadata.usage) ?? {
+				inputTokens: 0,
+				outputTokens: 0,
+				inputCost: 0,
+				outputCost: 0
+			};
+			iteration.llm = {
+				started_at: startedAt,
+				ended_at: Date.now(),
+				status: "error",
+				cached: (responseMetadata === null || responseMetadata === void 0 ? void 0 : responseMetadata.cached) ?? false,
+				tokens: usage.inputTokens + usage.outputTokens,
+				spend: (responseMetadata === null || responseMetadata === void 0 ? void 0 : responseMetadata.cost) ?? usage.inputCost + usage.outputCost,
+				output: raw,
+				diagnostics: parser.diagnostics,
+				model: (responseMetadata === null || responseMetadata === void 0 ? void 0 : responseMetadata.model) ?? model.id,
+				time_to_first_token: timeToFirstToken,
+				time_to_last_token: timeToLastToken,
+				usage
+			};
+			throw error;
 		} finally {
 			streamController.abort("LLM stream closed");
 			if (!streamCompleted) stream.return(void 0).catch((err) => {});
+			if (!accepted && liveContent.size) await preview({
+				restart: true,
+				iterationId: iteration.id,
+				attempt: attempt + 1,
+				fromModel: model.id,
+				toModel: model.id,
+				reason: "invalid or incomplete response envelope"
+			});
 		}
-		if (midStreamFallback) controller.signal.throwIfAborted();
+		controller.signal.throwIfAborted();
 	} else {
 		const response = await cognitive.generateText(input, { signal: controller.signal }).catch((thrown) => {
 			throw new CognitiveError(`LLM generation failed: ${getErrorMessage(thrown)}`);
 		});
+		controller.signal.throwIfAborted();
 		if (response.error) throw new CognitiveError(`LLM generation failed: ${response.error}`);
 		if (!response.output) throw new CognitiveError("LLM did not return any text output");
 		responseMetadata = response.metadata;
 		assertSuccessfulGeneration(responseMetadata);
 		raw = response.output;
-		assistantResponse = ctx.version.parseAssistantResponse(raw);
+		assistantResponse = ctx.version.parseAssistantResponse(raw, responseMetadata.stopReason);
 		for (const [index, send] of assistantResponse.sends.entries()) await (onSend === null || onSend === void 0 ? void 0 : onSend(send, messageMetadata(`send-${index}`)));
 	}
 	iteration.code = assistantResponse.code;
@@ -564,8 +570,10 @@ const finalizeIteration = async ({ iteration, status, controller, onIterationEnd
 //#region src/runtime/tool-wrapper.ts
 const SLOW_TOOL_WARNING = ms("15s");
 function wrapTool({ chat, tool, traces, object, iteration, beforeHook, afterHook, controller }) {
-	const getToolInput = (input) => tool.zInput.safeParse(input).data ?? input;
+	const traceSchema = tool.input ? fromJSONSchemaCompat(tool.input) : void 0;
+	const getToolInput = (input) => (traceSchema === null || traceSchema === void 0 ? void 0 : traceSchema.safeParse(input).data) ?? input;
 	return async function(input) {
+		controller.signal.throwIfAborted();
 		const toolCallId = `tcall_${ulid()}`;
 		const originalInput = input;
 		let effectiveInput = input;
@@ -641,6 +649,7 @@ function wrapTool({ chat, tool, traces, object, iteration, beforeHook, afterHook
 				object,
 				toolCallId
 			}));
+			controller.signal.throwIfAborted();
 			if (typeof (beforeRes === null || beforeRes === void 0 ? void 0 : beforeRes.input) !== "undefined") effectiveInput = beforeRes.input;
 			output = await tool.execute(effectiveInput, {
 				callId: toolCallId,
@@ -657,9 +666,16 @@ function wrapTool({ chat, tool, traces, object, iteration, beforeHook, afterHook
 			}));
 			if (typeof (afterRes === null || afterRes === void 0 ? void 0 : afterRes.output) !== "undefined") output = afterRes.output;
 		} catch (err) {
-			if (!await handleSignals(err)) {
+			try {
+				if (!await handleSignals(err)) {
+					success = false;
+					error = err;
+					output = void 0;
+				}
+			} catch (hookError) {
 				success = false;
-				error = err;
+				error = hookError;
+				output = void 0;
 			}
 		} finally {
 			clearTimeout(alertSlowTool);
@@ -959,8 +975,6 @@ const executeIteration = async ({ iteration, ctx, cognitive, controller, onExit,
 			};
 		});
 	};
-	const canExecuteEarly = typeof onBeforeExecution !== "function" && !ctx.midStreamFallback;
-	let earlyExecution;
 	await generateCode({
 		iteration,
 		ctx,
@@ -968,15 +982,6 @@ const executeIteration = async ({ iteration, ctx, cognitive, controller, onExit,
 		controller,
 		metadata,
 		onRunStart: () => warmupVM(),
-		onRunComplete: canExecuteEarly ? (code) => {
-			if (!code.length || controller.signal.aborted || earlyExecution) return;
-			iteration.code = code;
-			earlyExecution = {
-				code,
-				started_at: Date.now(),
-				promise: runCode(code)
-			};
-		} : void 0,
 		onSend: async (send, messageMetadata) => {
 			if (!ctx.chat) return;
 			const sendStartedAt = Date.now();
@@ -1001,7 +1006,6 @@ const executeIteration = async ({ iteration, ctx, cognitive, controller, onExit,
 		},
 		onSendDelta: ((_ctx$chat = ctx.chat) === null || _ctx$chat === void 0 ? void 0 : _ctx$chat.onMessageDelta) ? (delta) => ctx.chat.onMessageDelta(delta) : void 0
 	});
-	if (earlyExecution) iteration.code = earlyExecution.code;
 	if (typeof onBeforeExecution === "function") try {
 		const hookRes = await onBeforeExecution(iteration, controller);
 		if (typeof (hookRes === null || hookRes === void 0 ? void 0 : hookRes.code) === "string" && hookRes.code.trim().length > 0) iteration.code = hookRes.code.trim();
@@ -1039,7 +1043,7 @@ const executeIteration = async ({ iteration, ctx, cognitive, controller, onExit,
 		return;
 	}
 	if (!iteration.code) {
-		var _iteration$sends;
+		var _iteration$llm;
 		if (iteration.next) {
 			await applyNextExit({
 				iteration,
@@ -1048,26 +1052,14 @@ const executeIteration = async ({ iteration, ctx, cognitive, controller, onExit,
 			});
 			return;
 		}
-		if (ctx.chat && ((_iteration$sends = iteration.sends) === null || _iteration$sends === void 0 ? void 0 : _iteration$sends.length)) {
-			iteration.next = {
-				name: "listen",
-				props: {}
-			};
-			await applyNextExit({
-				iteration,
-				controller,
-				onExit
-			});
-			return;
-		}
 		iteration.end({
 			type: "invalid_code_error",
-			invalid_code_error: { message: "The response did not include a ■run block or a ■next exit. Reply using ■ blocks and end your response with ■run or ■next=<exit>." }
+			invalid_code_error: { message: ((_iteration$llm = iteration.llm) === null || _iteration$llm === void 0 || (_iteration$llm = _iteration$llm.diagnostics) === null || _iteration$llm === void 0 || (_iteration$llm = _iteration$llm.find((diagnostic) => diagnostic.code === "invalid-envelope")) === null || _iteration$llm === void 0 ? void 0 : _iteration$llm.message) ?? "The response did not include a ■run block or a ■next exit. Reply with ■start, the required ■ blocks, and ■end." }
 		});
 		return;
 	}
-	const startedAt = (earlyExecution === null || earlyExecution === void 0 ? void 0 : earlyExecution.started_at) ?? Date.now();
-	const result = earlyExecution ? await earlyExecution.promise : await runCode(iteration.code ?? "");
+	const startedAt = Date.now();
+	const result = await runCode(iteration.code);
 	await interpretVMResult({
 		iteration,
 		result,

package/dist/{exit-DUM96DN1.cjs → exit-CGLXI0BH.cjs}

@@ -1,6 +1,6 @@
-const require_compiler = require("./compiler-C-OI9sim.cjs");
+const require_compiler = require("./compiler-BJJUmNS9.cjs");
 const require_uniq = require("./uniq-G872RWmE.cjs");
-const require_utils = require("./utils-3ESwP3yg.cjs");
+const require_utils = require("./utils-DGQ4sRke.cjs");
 let _bpinternal_zui = require("@bpinternal/zui");
 //#region src/exit.ts
 var exit_exports = /* @__PURE__ */ require_compiler.__exportAll({ Exit: () => Exit });

package/dist/index.cjs

@@ -1,18 +1,18 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_common = require("./common-DdArNQhl.cjs");
-const require_dual_modes = require("./dual-modes-Cb7ThvoV.cjs");
-const require_custom_client = require("./custom-client-HkM1Sdzv.cjs");
-const require_utils = require("./utils-3ESwP3yg.cjs");
-const require_component = require("./component-BXS8vAwO.cjs");
-const require_tool = require("./tool-Dy6AJpJH.cjs");
+const require_dual_modes = require("./dual-modes-BNHlj2qM.cjs");
+const require_common = require("./common-DJkSpeqw.cjs");
+const require_custom_client = require("./custom-client-B_o56CB4.cjs");
+const require_utils = require("./utils-DGQ4sRke.cjs");
+const require_tool = require("./tool-BLTrA-sL.cjs");
 const require_errors = require("./errors-C962uJdS.cjs");
-const require_typings = require("./typings-3lsqCbkn.cjs");
-const require_exit = require("./exit-DUM96DN1.cjs");
-const require_truncator = require("./truncator-CLkouTCO.cjs");
+const require_typings = require("./typings-DXJMu59O.cjs");
+const require_exit = require("./exit-CGLXI0BH.cjs");
+const require_component = require("./component-CPKXe6Ca.cjs");
+const require_truncator = require("./truncator-DmCu9M4m.cjs");
 const require_quickjs_variant = require("./quickjs-variant-CsIwTVFC.cjs");
 let _bpinternal_zui = require("@bpinternal/zui");
 //#region package.json
-var version = "0.8.0";
+var version = "0.9.1";
 //#endregion
 //#region src/hoist.ts
 /**
@@ -792,6 +792,249 @@ var CitationsManager = class {
 	}
 };
 //#endregion
+//#region src/component.default.ts
+const Button = new require_component.Component({
+	type: "leaf",
+	description: "A button component that can perform actions when clicked",
+	name: "Button",
+	aliases: ["btn"],
+	generation: {
+		usage: "Offer quick actions or choices after a message. It is common to send several buttons together: write one separate ■send=button block per choice in the SAME response. Each button has its own props and no body. Send all the choices before the final exit; do not wait for a user reply between buttons.",
+		examples: [
+			{ props: {
+				action: "say",
+				label: "Track my order"
+			} },
+			{ props: {
+				action: "url",
+				label: "View guide",
+				url: "https://example.com/guide"
+			} },
+			{ props: {
+				action: "postback",
+				label: "Choose Standard",
+				value: "plan_standard"
+			} },
+			[
+				{ props: {
+					action: "say",
+					label: "Track my order"
+				} },
+				{ props: {
+					action: "say",
+					label: "Return an item"
+				} },
+				{ props: {
+					action: "say",
+					label: "Contact support"
+				} }
+			]
+		]
+	},
+	leaf: { props: _bpinternal_zui.z.object({
+		action: _bpinternal_zui.z.enum([
+			"say",
+			"url",
+			"postback"
+		]).default("say").describe("The action to perform when the button is clicked. Can be \"say\", \"url\", or \"postback\""),
+		label: _bpinternal_zui.z.string().describe("The text displayed on the button (min 1 character, max 250 characters)"),
+		value: _bpinternal_zui.z.string().optional().describe("The postback value to send when the button is clicked. Required if action is \"postback\""),
+		url: _bpinternal_zui.z.string().optional().describe("The URL to open when the button is clicked. Required if action is \"url\"")
+	}) }
+});
+const Image = new require_component.Component({
+	type: "leaf",
+	name: "Image",
+	description: "Displays an image from a URL.",
+	aliases: [],
+	generation: {
+		usage: "Use a known image URL from the user or tool results; never invent an image URL. No body.",
+		examples: [{ props: {
+			url: "https://example.com/trail.jpg",
+			alt: "Forest trail beside a lake"
+		} }]
+	},
+	leaf: { props: _bpinternal_zui.z.object({
+		url: _bpinternal_zui.z.string().describe("The URL of the image (must be valid)"),
+		alt: _bpinternal_zui.z.string().optional().describe("Alternative text describing the image")
+	}) }
+});
+const File = new require_component.Component({
+	type: "leaf",
+	name: "File",
+	description: "Sends a downloadable file to the user.",
+	aliases: [],
+	generation: { examples: [{ props: {
+		url: "https://example.com/report.pdf",
+		name: "Report.pdf"
+	} }] },
+	leaf: { props: _bpinternal_zui.z.object({
+		url: _bpinternal_zui.z.string().describe("The URL of the file (must be valid)"),
+		name: _bpinternal_zui.z.string().optional().describe("The display name of the file")
+	}) }
+});
+const Video = new require_component.Component({
+	type: "leaf",
+	name: "Video",
+	description: "Embeds a video from a URL.",
+	aliases: [],
+	generation: { examples: [{ props: {
+		url: "https://example.com/intro.mp4",
+		title: "Welcome"
+	} }] },
+	leaf: { props: _bpinternal_zui.z.object({
+		url: _bpinternal_zui.z.string().describe("The URL of the video (must be valid)"),
+		title: _bpinternal_zui.z.string().optional().describe("Title for the video")
+	}) }
+});
+const Audio = new require_component.Component({
+	type: "leaf",
+	name: "Audio",
+	description: "Plays an audio clip from a URL.",
+	aliases: [],
+	generation: { examples: [{ props: {
+		url: "https://example.com/audio.mp3",
+		title: "Sample"
+	} }] },
+	leaf: { props: _bpinternal_zui.z.object({
+		url: _bpinternal_zui.z.string().describe("The URL of the audio clip (must be valid)"),
+		title: _bpinternal_zui.z.string().optional().describe("Title for the audio clip")
+	}) }
+});
+const Card = new require_component.Component({
+	type: "container",
+	name: "Card",
+	description: "A card with a title, optional subtitle, and Markdown body.",
+	aliases: [],
+	generation: {
+		usage: "Present one item. The block body is Markdown, not nested component blocks or JSX.",
+		examples: [{
+			props: {
+				title: "Standard plan",
+				subtitle: "$20/month"
+			},
+			body: "Includes 5 projects and email support."
+		}]
+	},
+	container: {
+		props: _bpinternal_zui.z.object({
+			title: _bpinternal_zui.z.string().min(1).max(250).describe("Title text (1–250 characters)"),
+			subtitle: _bpinternal_zui.z.string().optional().describe("Optional subtitle for the card")
+		}),
+		children: [{
+			description: "Image (optional, max 1)",
+			component: Image.definition
+		}, {
+			description: "Button (optional, up to 5)",
+			component: Button.definition
+		}]
+	}
+});
+const carouselProps = _bpinternal_zui.z.object({ cards: _bpinternal_zui.z.array(Card.definition.container.props.extend({
+	body: _bpinternal_zui.z.string().optional().describe("Markdown text for this card"),
+	image: Image.definition.leaf.props.optional().describe("Optional image for this card; use a known URL"),
+	buttons: _bpinternal_zui.z.array(Button.definition.leaf.props).max(5).optional().describe("Up to 5 actions for this card")
+})).min(1).max(10).describe("1–10 cards, in display order. Each card has its own title, optional subtitle, body, image, and buttons") });
+var CarouselComponent = class extends require_component.Component {
+	render(props, children = []) {
+		if (!("cards" in props) && children.length && children.every((child) => require_component.isComponent(child, Card))) return super.render(props, children);
+		const { cards } = carouselProps.parse(props);
+		const renderedCards = cards.map(({ body, image, buttons, ...cardProps }) => Card.render(cardProps, [
+			...body ? [body] : [],
+			...image ? [Image.render(image)] : [],
+			...(buttons ?? []).map((button) => Button.render(button))
+		]));
+		return super.render({}, renderedCards);
+	}
+};
+const DefaultComponents = {
+	Button,
+	Image,
+	File,
+	Video,
+	Audio,
+	Card,
+	Carousel: new CarouselComponent({
+		type: "container",
+		name: "Carousel",
+		description: "Displays a horizontally scrollable collection of cards, each with its own content and actions.",
+		aliases: [],
+		body: false,
+		generation: {
+			usage: "Use for several comparable items. Put ALL cards in the cards array of ONE send block. Each card can include title, subtitle, body, image {url, alt?}, and buttons [{action, label, value?, url?}]. Do not write a Markdown list or separate Card blocks; those do not form a carousel.",
+			examples: [{ props: { cards: [{
+				title: "Standard plan",
+				subtitle: "$20/month",
+				body: "5 projects and email support.",
+				image: {
+					url: "https://example.com/standard.jpg",
+					alt: "Standard plan"
+				},
+				buttons: [{
+					action: "postback",
+					label: "Choose Standard",
+					value: "plan_standard"
+				}]
+			}, {
+				title: "Team plan",
+				subtitle: "$50/month",
+				body: "20 projects and priority support.",
+				image: {
+					url: "https://example.com/team.jpg",
+					alt: "Team plan"
+				},
+				buttons: [{
+					action: "postback",
+					label: "Choose Team",
+					value: "plan_team"
+				}]
+			}] } }]
+		},
+		container: {
+			props: carouselProps,
+			children: [{
+				description: "Card component (required, 1–10 allowed)",
+				component: Card.definition
+			}]
+		}
+	}),
+	Text: new require_component.Component({
+		type: "default",
+		name: "Message",
+		aliases: ["Text", "Markdown"],
+		description: "A Markdown-formatted text message. Long answers are written the same way: plain Markdown prose.",
+		generation: { examples: [{ body: `To reset your password:
+
+1. Open the sign-in page and select **Forgot password?**
+2. Enter the email address you use for your account.
+3. Open the reset link in your email and choose a new password.
+
+If the email does not arrive, check your spam folder. If you sign in through your organization, use its password reset process.` }, { body: "How do you currently manage board meetings?" }] },
+		default: {
+			props: _bpinternal_zui.z.object({}),
+			children: []
+		}
+	}),
+	Speech: new require_component.Component({
+		type: "default",
+		name: "Speech",
+		aliases: ["speak", "spoken"],
+		description: "A message spoken aloud to the user via text-to-speech.",
+		body: {
+			format: "text",
+			description: "Plain conversational prose only, written to be read aloud: no Markdown, no links or URLs, no emojis, no code, no bullet points, tables or headings. Write everything the way it should be pronounced — spell out numbers, dates, units and abbreviations (e.g. \"June third at three thirty PM\", not \"06/03 @ 3:30pm\")."
+		},
+		generation: {
+			usage: "Use when the reply will be played back as audio (voice conversations).",
+			examples: [{ body: "Sure! Your order shipped this morning and should arrive on Tuesday, June third, around noon." }]
+		},
+		default: {
+			props: _bpinternal_zui.z.object({}),
+			children: []
+		}
+	})
+};
+//#endregion
 //#region src/chat.ts
 /**
 * Base class for implementing chat interfaces in LLMz agents.
@@ -1450,7 +1693,7 @@ const utils = {
 * })
 */
 const execute = async (props) => {
-	const { executeContext } = await Promise.resolve().then(() => require("./execute-COIHOIKR.cjs"));
+	const { executeContext } = await Promise.resolve().then(() => require("./execute-0bvqakr7.cjs"));
 	return executeContext(props);
 };
 /**
@@ -1459,16 +1702,16 @@ const execute = async (props) => {
 * It's recommended to call this function at the beginning of your application without awaiting it (void init())
 */
 const init = async () => {
-	await Promise.resolve().then(() => require("./execute-COIHOIKR.cjs"));
-	await Promise.resolve().then(() => require("./component-BXS8vAwO.cjs")).then((n) => n.component_exports);
-	await Promise.resolve().then(() => require("./tool-Dy6AJpJH.cjs")).then((n) => n.tool_exports);
-	await Promise.resolve().then(() => require("./exit-DUM96DN1.cjs")).then((n) => n.exit_exports);
-	await Promise.resolve().then(() => require("./jsx-D5Y2cPo-.cjs")).then((n) => n.jsx_exports);
-	await Promise.resolve().then(() => require("./vm-D6s1zF6M.cjs"));
-	await Promise.resolve().then(() => require("./utils-3ESwP3yg.cjs")).then((n) => n.utils_exports);
-	await Promise.resolve().then(() => require("./truncator-CLkouTCO.cjs")).then((n) => n.truncator_exports);
-	await Promise.resolve().then(() => require("./typings-3lsqCbkn.cjs")).then((n) => n.typings_exports);
-	await Promise.resolve().then(() => require("./dual-modes-Cb7ThvoV.cjs")).then((n) => n.dual_modes_exports);
+	await Promise.resolve().then(() => require("./execute-0bvqakr7.cjs"));
+	await Promise.resolve().then(() => require("./component-CPKXe6Ca.cjs")).then((n) => n.component_exports);
+	await Promise.resolve().then(() => require("./tool-BLTrA-sL.cjs")).then((n) => n.tool_exports);
+	await Promise.resolve().then(() => require("./exit-CGLXI0BH.cjs")).then((n) => n.exit_exports);
+	await Promise.resolve().then(() => require("./jsx-BJ6GWXI2.cjs")).then((n) => n.jsx_exports);
+	await Promise.resolve().then(() => require("./vm-X0uTj5Aa.cjs"));
+	await Promise.resolve().then(() => require("./utils-DGQ4sRke.cjs")).then((n) => n.utils_exports);
+	await Promise.resolve().then(() => require("./truncator-DmCu9M4m.cjs")).then((n) => n.truncator_exports);
+	await Promise.resolve().then(() => require("./typings-DXJMu59O.cjs")).then((n) => n.typings_exports);
+	await Promise.resolve().then(() => require("./dual-modes-BNHlj2qM.cjs")).then((n) => n.dual_modes_exports);
 };
 //#endregion
 exports.BaseResponse = BaseResponse;
@@ -1476,7 +1719,7 @@ exports.Chat = Chat;
 exports.CitationsManager = CitationsManager;
 exports.Component = require_component.Component;
 exports.ComponentRegistry = require_dual_modes.ComponentRegistry;
-exports.DefaultComponents = require_dual_modes.DefaultComponents;
+exports.DefaultComponents = DefaultComponents;
 exports.DefaultExit = require_custom_client.DefaultExit;
 exports.ErrorExecutionResult = require_custom_client.ErrorExecutionResult;
 exports.Example = require_dual_modes.Example;